2026赛季交龙视觉部招新环境配置指南
写在前面 往年的教程中,我们推荐使用 VMware 虚拟机。但随着 Windows 的更新,WSL2 (Windows Subsystem for Linux 2) 已经成为更高效、更轻量、与 Windows 融合度更好的选择。 为什么选择 WSL2?
- 性能强劲:几乎接近原生 Linux 的运行速度。
- 文件互通:在 Windows 文件资源管理器中直接访问 Linux 文件。
- IDE 无缝集成:使用 Windows 上的 VSCode 直接编辑和调试 Linux 代码。
- GUI 支持:现在的 WSL2 (WSLg) 原生支持运行带图形界面的 Linux 程序(如 OpenCV 的
imshow窗口),无需额外配置。即使你从未接触过 Linux,按照本教程操作,也可以在 30 分钟内搭建好视觉开发环境。
准备工作
- 操作系统:Windows 10 (版本 2004 及更高) 或 Windows 11(推荐)。
- 网络环境:建议科学上网,以便顺利下载所需软件包。
- 心态:遇到报错不要慌,复制相关信息问我们,或者直接喂给 AI。
安装 WSL2 与 Ubuntu
现在的 WSL 安装非常简单,只需要一条命令。
- 打开终端:右键点击 Windows 开始菜单,选择 “终端 (管理员)” 或 “PowerShell (管理员)”。
- 输入安装命令: 我们将安装 Ubuntu 24.04 LTS 版本
wsl --install -d Ubuntu-24.04
注:如果你之前安装过 WSL,可能需要先执行 wsl --update 更新内核。
- 重启电脑:命令执行完毕后,系统通常会提示重启。重启后,Ubuntu 的终端窗口会自动弹出。
设置账户:
- 按照提示输入你想要的 UNIX username (用户名)。
- 输入 password (密码)。注意:输入密码时屏幕上不会有任何显示,这是正常的,输完回车即可。
恭喜你,你已经拥有了一个完整的 Linux 系统!
安装开发工具与依赖库
笔试及后续开发需要用到:C++ 编译器、CMake 构建工具、OpenCV、Eigen、Ceres。
1. 安装基础编译工具
sudo apt install build-essential cmake git gdb -y
2. 安装 Eigen3 (线性代数库)
Eigen 是一个纯头文件库,安装非常简单:
sudo apt install libeigen3-dev -y
3. 安装 Ceres Solver (非线性优化库)
Ceres 用于解决最小二乘问题,是视觉开发中的常客:
sudo apt install libceres-dev -y
4. 安装 OpenCV (计算机视觉库)
为了方便笔试,直接通过 apt 安装 OpenCV 开发包(这会节省数小时的编译时间):
sudo apt install libopencv-dev python3-opencv -y
第四步:配置 VSCode 开发环境
这是最舒适的开发方式:在 Windows 上运行 VSCode,但它实际上是在操作 WSL 里的文件。
- 安装 VSCode:在 Windows 上下载并安装 Visual Studio Code。
- 安装 WSL 插件:打开 VSCode,点击左侧扩展图标,搜索并安装 “WSL” 插件。
- 连接到 WSL:
- 回到 Ubuntu 终端窗口。
- 输入以下命令启动 VSCode:
code .
- VSCode 会自动安装服务端,稍等片刻后,左下角会显示绿色状态条 “WSL: Ubuntu-24.04”。
配置 C++ 插件 (推荐 Clangd)
为了获得更好的代码补全和跳转体验,我们强烈推荐使用 Clangd 替代默认的 C++ 插件。
- 在 WSL 中安装 Clangd 后端: 在 Ubuntu 终端中输入:
sudo apt install clangd -y
- 在 VSCode 中安装插件: 在 VSCode 的扩展商店中(确是在 WSL 目标下),搜索并安装 clangd。
- 禁用默认 IntelliSense: VSCode 可能会提示 Clangd 与 C/C++ 插件冲突,选择 “Disable C/C++ IntelliSense” (仅禁用智能提示,保留调试功能)。
常见问题
Q: 能够编译通过,但是 cv::imshow 报错或没有窗口弹出?
A:
- 确保你的 Windows 版本较新(Win10 21H2 或 Win11),这些版本自带 WSLg。
- 如果在老版本 Win10 上,可能需要安装 VcXsrv(但还是建议升级系统)。
- 检查是否显卡驱动正常(在 Windows 端更新显卡驱动即可,WSL 会自动映射)。
Q: VSCode 提示 “Permission denied”?
A: 不要在 Linux 的系统目录(如 /root 或 /etc)下写代码。请始终在你的用户目录 ~ (即 /home/你的用户名/) 下创建项目文件夹。
Q: 怎么把文件在 Windows 和 WSL 之间传输?
A:
- 方法1 (推荐):在 WSL 终端输入
explorer.exe .,会直接弹出当前目录的 Windows 文件夹窗口。 - 方法2:在 VSCode 中直接拖拽。
遇到搞不定的问题? 欢迎在招新群内提问
祝笔试顺利!