在 Ubuntu 上安装 Visual Studio Code (VS Code) 主要有三种方法。考虑到您正在搭建 ROS 2 开发环境,我强烈推荐使用 .deb 包安装或 apt 仓库安装,而不是 Snap 版本。

原因: Snap 版本运行在沙盒中,可能会遇到权限问题(例如无法访问 Docker 套接字、无法识别某些串口设备 /dev/ttyUSB* 等),这对 ROS 开发可能造成不便。


方法一:下载 .deb 包安装(最推荐 ✅)

这是官方最稳定的安装方式,适合大多数用户。

  1. 下载安装包 访问官网下载页面:https://code.visualstudio.com/download 点击 .deb 按钮下载(例如 code_1.xx.x_amd64.deb)。

  2. 安装 打开终端,进入下载目录(通常是 Downloads),运行:

    cd ~/Downloads
    sudo apt install ./code_*.deb

    apt 会自动处理依赖关系。

  3. 启动 在应用菜单中搜索 "Visual Studio Code" 或直接在终端输入:

    code

方法二:使用 apt 仓库安装(方便更新 ✅)

这种方式配置后,可以通过 sudo apt update 随时更新 VS Code。

  1. 安装依赖工具

    sudo apt update
    sudo apt install software-properties-common apt-transport-https wget
  2. 导入 GPG 密钥和仓库

    wget -q https://packages.microsoft.com/keys/microsoft.asc -O- | sudo apt-key add -
    sudo add-apt-repository "deb [arch=amd64] https://packages.microsoft.com/repos/vscode stable main"
  3. 安装 VS Code

    sudo apt update
    sudo apt install code

方法三:使用 Snap 安装(最快,但有权限限制 ⚠️)

如果您不介意潜在的沙盒权限问题,这是最快的方法。

sudo snap install code --classic

关键步骤:配置 ROS 2 开发插件

安装好 VS Code 后,为了高效开发 ROS 2,请务必安装以下插件(点击左侧扩展图标 Ctrl+Shift+X 搜索):

插件名称 发布者 作用
C/C++ Microsoft C++ 开发必备(智能提示、调试)
Python Microsoft Python 开发必备
CMake Tools Microsoft 管理 CMake 构建(ROS 2 使用 CMake)
ROS 2 Snippets various 提供 ROS 2 代码片段加速开发
Docker Microsoft 如果您使用 Docker 运行 ROS 2

关键配置:让 VS Code 终端自动加载 ROS 环境

默认情况下,VS Code 内置终端不会自动 source ROS 环境。您需要配置一下:

  1. 打开 VS Code 设置 (Ctrl + ,)。
  2. 搜索 terminal.integrated.env.linux
  3. 点击 "在 settings.json 中编辑"
  4. 添加以下配置(根据您的 ROS 版本修改 humble 或 jazzy):
"terminal.integrated.env.linux": {
    "ROS_VERSION": "2",
    "ROS_DISTRO": "humble", 
    "PATH": "/opt/ros/humble/bin:${env:PATH}",
    "PYTHONPATH": "/opt/ros/humble/lib/python3.10/site-packages:${env:PYTHONPATH}"
}

注意:更简单的方法是直接在 ~/.bashrc 中添加 source /opt/ros/humble/setup.bash,这样所有终端(包括 VS Code)都会自动加载。


验证安装

  1. 打开 VS Code。
  2. 打开内置终端 (Ctrl + ~)。
  3. 输入:
    code --version
  4. 输入 ROS 命令测试环境:
    ros2 --version
    如果能输出版本号,说明 VS Code 和 ROS 环境都配置成功了。

总结建议

  • 首选: 方法一(.deb 包),稳定且权限正常。
  • 必做: 安装 C/C++ 和 Python 插件。
  • 注意: 确保终端能识别 ros2 命令。
Logo

电影级数字人,免显卡端渲染SDK,十行代码即可调用,工业级demo免费开源下载!

更多推荐