使用wsl2的Ubuntu20.04运行opencv代码，运行至cv::imshow时报以下错误，请问如何解决？？

原创于 2025-06-19 21:54:07 发布 · 907 阅读

19 ·

CC 4.0 BY-SA版权

文章标签：

#opencv #c++ #linux #cvimshow

bug专栏专栏收录该内容

36 篇文章

订阅专栏

🏆 本文收录于《全栈Bug调优(实战版)》专栏，致力于分享我在项目实战过程中遇到的各类Bug及其原因，并提供切实有效的解决方案。无论你是初学者还是经验丰富的开发者，本文将为你指引出一条更高效的Bug修复之路，助你早日登顶，迈向财富自由的梦想🚀！同时，欢迎大家关注、收藏、订阅本专栏，更多精彩内容正在持续更新中。让我们一起进步，Up！Up！Up！

备注： 部分问题/难题源自互联网，经过精心筛选和整理，结合数位十多年大厂实战经验资深大佬经验总结所得，数条可行方案供所需之人参考。

全文目录：

📢 问题描述

问题来源：https://ask.csdn.net/questions/8427817

问题描述：使用wsl2的Ubuntu20.04运行opencv代码，运行至cv::imshow时报以下错误，请问如何解决？？

#include <iostream>
#include "opencv4/opencv2/opencv.hpp"
#include "opencv4/opencv2/highgui.hpp"
#include "opencv4/opencv2/imgproc.hpp"
 
using namespace cv;
using namespace std;
 
int main() {
    cv::Mat image = cv::imread("test.jpg");
    if(image.empty()) {
        std::cerr << "Error loading image" << std::endl;
        return -1;
    }
 
    std::cout << "OpenCV测试成功!" << std::endl;
    std::cout << "图像尺寸: " << image.cols << "x" << image.rows << std::endl;
    std::cout << "通道数: " << image.channels() << std::endl;
 
    cv::imshow("测试窗口", image);
    cv::waitKey(0);
 
    return 0;
}

具体截图如下：

📣 请知悉：如下方案不保证一定适配你的问题！

如下是针对上述问题进行专业角度剖析答疑，不喜勿喷，仅供参考：

✅️问题分析

你在运行 OpenCV 代码时，调用 cv::imshow() 显示图像时遇到错误，具体的错误信息是：

terminate called after throwing an instance of 'cv::Exception'
what(): OpenCV(4.6.0) /usr/games/opencv-4.6.0/modules/highgui/src/window_gtk.cpp:635: error: (-2:Unspecified error) Can't initialize GTK backend in function 'cvInitSystem'

这个错误表明 OpenCV 尝试初始化 GTK 后端时失败，导致无法显示窗口。这通常与在 WSL2 环境中运行 GUI 程序时的显示和窗口管理有关。

✅️问题原因

在 WSL2 环境中，由于 WSL2 本身不提供图形用户界面（GUI），你需要额外的配置才能通过 WSL2 显示 GUI 窗口。cv::imshow() 依赖于本地的窗口系统（如 X11 或 GTK）来创建图形界面窗口，在没有配置正确显示服务器的情况下，窗口显示会失败。

✅️解决方案

1. 安装并配置 X11 服务器

在 WSL2 中运行 OpenCV 时，你需要安装 X11 服务器 来支持图形界面的显示。你可以使用 VcXsrv 或 Xming 来作为 X11 服务器。

步骤：

在 Windows 上安装 VcXsrv：
- 下载并安装 VcXsrv。
启动 VcXsrv，选择 Multiple windows 和 Start no client。
配置 WSL2 使用 X11：
- 在 WSL2 中打开终端，输入以下命令来设置环境变量：
```
export DISPLAY=$(grep -oP '(?<=nameserver\s)[^\s]+' /etc/resolv.conf):0
```
- 你可以将上面的命令添加到 ~/.bashrc 或 ~/.zshrc 文件中，以便每次启动 WSL2 时都自动设置 DISPLAY 环境变量。
通过 VcXsrv 启动 X11 服务器后，重新运行你的 OpenCV 代码。

2. 安装 GTK 和 OpenCV 依赖

确保你的 WSL2 环境安装了所有必要的依赖，尤其是 GTK 库。运行以下命令来安装 GTK 依赖和其他 OpenCV 所需的库：
```
sudo apt update
sudo apt install libgtk-3-dev
sudo apt install libcanberra-gtk3-dev
sudo apt install libx11-dev
```

3. 测试 `cv::imshow()` 功能

通过以下命令，验证 GTK 是否已经正确安装并且 OpenCV 是否能够显示图像：
```
display test.jpg
```

如果该命令能够正常显示图像，说明你的 X11 配置已正确。如果仍然无法显示，重新检查 X11 配置。

4. 无头模式（Headless）解决方案（可选）

如果你不想使用图形界面来显示图像，可以考虑使用无头模式（headless）处理图像。无头模式通常用于服务器环境或没有 GUI 支持的地方，可以通过保存图像来替代显示：
```
cv::imwrite("output.jpg", image);
```

这种方法不依赖于 GUI，可以避免与 X11 或 GTK 的依赖问题。

✅️总结

安装 X11 服务器：使用 VcXsrv 或 Xming 等工具来启用 X11 显示支持，并在 WSL2 中配置 DISPLAY 环境变量。
安装 GTK 和其他依赖：确保 WSL2 中安装了所需的 GTK 库。
测试与 OpenCV 配合使用：通过 cv::imshow() 在 WSL2 环境中显示图像时，确保图形显示服务已正确设置。

通过以上步骤，你应该能够解决在 WSL2 中运行 OpenCV 时显示图像的问题。如果你仍然遇到问题，可以考虑使用无头模式替代 imshow() 来进行图像处理。

希望如上措施及解决方案能够帮到有需要的你。

PS：如若遇到采纳如下方案还是未解决的同学，希望不要抱怨&&急躁，毕竟影响因素众多，我写出来也是希望能够尽最大努力帮助到同类似问题的小伙伴，即把你未解决或者产生新Bug黏贴在评论区，我们大家一起来努力，一起帮你看看，可以不咯。

若有对当前Bug有与如下提供的方法不一致，有个不情之请，希望你能把你的新思路或新方法分享到评论区，一起学习，目的就是帮助更多所需要的同学，正所谓「赠人玫瑰，手留余香」。

🧧🧧 文末福利，等你来拿！🧧🧧

如上问题有的来自我自身项目开发，有的收集网站，有的来自读者…如有侵权，立马删除。再者，针对此专栏中部分问题及其问题的解答思路或步骤等，存在少部分搜集于全网社区及人工智能问答等渠道，若最后实在是没能帮助到你，还望见谅！并非所有的解答都能解决每个人的问题，在此希望屏幕前的你能够给予宝贵的理解，而不是立刻指责或者抱怨！如果你有更优解，那建议你出教程写方案，一同学习！共同进步。

ok，以上就是我这期的Bug修复内容啦，如果还想查找更多解决方案，你可以看看我专门收集Bug及提供解决方案的专栏《全栈Bug调优(实战版)》，都是实战中碰到的Bug，希望对你有所帮助。到此，咱们下期拜拜。

码字不易，如果这篇文章对你有所帮助，帮忙给 bug菌来个一键三连(关注、点赞、收藏) ，您的支持就是我坚持写作分享知识点传播技术的最大动力。

同时也推荐大家关注我的硬核公众号:「猿圈奇妙屋」 ；以第一手学习bug菌的首发干货，不仅能学习更多技术硬货，还可白嫖最新BAT大厂面试真题、4000G Pdf技术书籍、万份简历/PPT模板、技术文章Markdown文档等海量资料，你想要的我都有！

🫵 Who am I?

我是bug菌，CSDN | 掘金 | InfoQ | 51CTO | 华为云 | 阿里云 | 腾讯云等社区博客专家，C站博客之星Top30，华为云多年度十佳博主，掘金多年度人气作者Top40，掘金等各大社区平台签约作者，51CTO年度博主Top12，掘金/InfoQ/51CTO等社区优质创作者；全网粉丝合计 30w+；更多精彩福利点击这里；硬核微信公众号「猿圈奇妙屋」，欢迎你的加入！免费白嫖最新BAT互联网公司面试真题、4000G PDF电子书籍、简历模板等海量资料，你想要的我都有，关键是你不来拿。