Jetson Xavier NX(Ubuntu20.04) 上VScode集成OpenCV C++环境：避坑与高效配置指南

最新推荐文章于 2026-02-25 14:03:43 发布

原创

最新推荐文章于 2026-02-25 14:03:43 发布 · 181 阅读

标签

#Jetson Xavier NX #OpenCV #VScode配置 #C++开发

1. 环境准备与VSCode安装避坑

在Jetson Xavier NX上配置开发环境，第一步就是选择合适的VSCode版本。我刚开始直接下载了最新版，结果发现根本打不开，白白浪费了半天时间。后来查资料才发现，Jetson Xavier NX的ARM64架构对VSCode版本有严格要求，1.70以上版本在Ubuntu 20.04上存在兼容性问题。

经过多次测试，我发现code_1.65.2-1646922911_arm64.deb这个版本最稳定。下载方法很简单，直接访问VSCode官网的下载链接，把版本号替换成1.65.2即可。如果你已经安装了其他版本的VSCode，需要先彻底卸载：

sudo apt remove code
sudo apt purge code
sudo apt autoremove
sudo apt clean
sudo dpkg --remove code

卸载完成后，进入下载目录执行安装命令：

sudo dpkg -i code_1.65.2-1646922911_arm64.deb

安装过程中可能会提示缺少依赖，这时候运行sudo apt --fix-broken install就能自动修复。安装完成后，在应用程序菜单中就能找到VSCode了。

这里有个小技巧：建议把VSCode固定在任务栏，因为后续的配置过程中需要频繁使用。另外，第一次启动VSCode时可能会比较慢，这是正常现象，ARM架构的设备需要一些时间来初始化环境。

2. 必备扩展安装与项目初始化

VSCode安装完成后，接下来就是安装必要的扩展。对于OpenCV C++开发，这三个扩展是必须的：C/C++扩展包、CMake工具和CMake集成。在扩展商店中搜索安装即可，注意要选择官方发布的版本。

安装完扩展后，需要创建一个项目目录结构。我建议按照以下方式组织：

project_folder/
├── src/
│   └── main.cpp
├── include/
├── lib/
└── build/

用VSCode打开项目文件夹后，第一件事就是创建CMakeLists.txt文件。这个文件是CMake构建系统的核心，告诉编译器如何编译你的项目。对于OpenCV项目，基础的CMakeLists.txt应该包含这些内容：

cmake_minimum_required(VERSION 3.10)
project(YourProjectName)

set(CMAKE_CXX_STANDARD 14)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

find_package(OpenCV REQUIRED)
include_directories(${OpenCV_INCLUDE_DIRS})

add_executable(main src/main.cpp)
target_link_libraries(main ${OpenCV_LIBS})

创建完CMakeLists.txt后，按Ctrl+Shift+P打开命令面板，输入"CMake: Configure"来配置项目。这时候可能会提示选择工具链，对于Jetson Xavier NX，应该选择aarch64-linux-gnu-g++编译器。

配置过程中最常见的错误是找不到OpenCV包，这通常是因为OpenCV没有正确安装或者CMake找不到安装路径。在Jetson平台上，OpenCV通常