Jetson NX5安装VSCode后无法正常启动运行的问题求助
问题诱发原因
- 你执行的
git clone --recursive https://github.com/Microsoft/vscode.git操作完全不属于VSCode的安装流程。该命令拉取的是VSCode的全量源代码,不是预编译好的可执行程序,不经过复杂的编译流程根本无法直接运行,执行完这条命令你本地不会生成可启动的VSCode程序。 - 架构包选择错误。Jetson NX5属于ARM64(aarch64)硬件架构,如果你之前安装的是面向普通PC的x86_64(amd64)版本VSCode安装包,程序和硬件架构完全不匹配,安装后必然无法启动,会直接报执行格式错误。
- GPU硬件加速兼容问题。VSCode基于Electron框架开发,默认开启GPU硬件加速,Jetson设备搭载的是NVIDIA定制L4T系统,其GPU驱动和Electron的硬件加速模块存在已知兼容问题,即便安装了正确架构的安装包,也可能出现启动闪退、黑屏、无窗口响应的故障。
- 系统依赖缺失。L4T定制版Ubuntu相比标准桌面版Ubuntu裁剪了部分桌面组件,缺少Electron应用运行必需的
libgtk-3、libgbm、libnss3等依赖库时,也会导致VSCode启动失败。
可行解决方法
- 先清理所有错误操作残留:执行
sudo apt remove code -y && sudo rm -rf ./vscode,删掉之前拉取的源码文件夹、卸载错误安装的程序包。 - 安装适配ARM64架构的官方预编译VSCode安装包,不要尝试自行编译源码(源码编译需要配置完整的Node.js、C++编译工具链,步骤繁琐耗时长,普通用户无必要操作)。下载对应ARM64架构的deb安装包后,执行
sudo apt install ./code_*_arm64.deb完成安装,安装过程会自动补全大部分可识别的缺失依赖。 - 若安装正确架构的包后仍启动异常,先执行
code --disable-gpu测试启动,该命令会禁用GPU硬件加速绕开兼容问题。如果该命令下VSCode可以正常打开,直接修改桌面启动快捷方式的执行参数,永久追加--disable-gpu即可。 - 若启动时提示依赖错误,先执行
sudo apt install -f自动修复依赖关系,再执行sudo apt install libgtk-3-0 libgbm1 libnss3 libxss1 libasound2 -y补全Electron运行必需的依赖库,之后重新尝试启动即可。 - 如果官方ARM64版本仍存在兼容问题,可以选择适配ARM64嵌入式设备的VSCode开源衍生构建版本,这类版本一般会针对Jetson这类边缘设备做专门的兼容优化。
内容的提问来源于stack exchange,提问作者Ali Ganjbakhsh
相关产品推荐
相关产品推荐

