apt安装最稳妥：自动更新、依赖干净、启动快；snap版版本滞后、启动慢、code命令常不可用；.deb包适合离线场景但需手动升级。
直接用 apt 安装是最稳妥的，能自动更新、依赖干净、启动快；别图省事用 Snap 或软件中心安装，后者版本滞后、启动慢、终端命令 code 常常不可用。
用 apt 安装 VS Code（推荐）
这是 Ubuntu 20.04+（包括 22.04、24.04、26.04）官方支持的方式，微软维护源，升级无感。
- 先导入 GPG 密钥：
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -（注意：新系统可能提示apt-key已弃用，可跳过，后续步骤仍有效） - 添加仓库：
sudo add-apt-repository "deb [arch=amd64,arm64,armhf] https://packages.microsoft.com/repos/code stable main" - 更新并安装：
sudo apt update && sudo apt install -y code - 验证是否可用：
code --version应输出类似1.92.2的版本号
如果报错说找不到 add-apt-repository，先运行：sudo apt install -y software-properties-common
手动安装 .deb 包（离线/内网/快速验证）
适合无法访问微软源、或临时测试新版本的场景。注意：不会自动升级，需手动替换。
- 下载最新稳定版：
wget -O vscode.deb https://code.visualstudio.com/sha/download?build=stable&os=linux-deb-x64 - 安装：
sudo dpkg -i vscode.deb - 若提示依赖错误（如
libxkbfile1），执行：sudo apt --fix-broken install - 完成后仍建议运行一次
code --version确认命令行可用
⚠️ 不要用 gdebi 或双击图形界面安装 —— 它可能绕过 apt 数据库，导致后续 apt upgrade 冲突或 code 命令失效。
C/C++ 环境跑不起来？关键在 launch.json 和 tasks.json
装完插件只是第一步。VS Code 默认不带编译器，F5 调试失败几乎全是配置缺失导致的，不是插件没装全。
- 确保已安装
g++：sudo apt install -y build-essential - 打开项目文件夹后，按
Ctrl+Shift+P→ 输入Tasks: Configure Default Build Task→ 选g++ build active file，会生成.vscode/tasks.json - 再按
Ctrl+Shift+P→Debug: Open launch.json→ 选C++ (GDB/LLDB)→ 选g++ build and debug active file - 检查生成的
launch.json中program字段是否指向./${fileBasenameNoExtension}，且miDebuggerPath是/usr/bin/gdb（默认即如此）
常见报错 Cannot find program 'xxx' to debug，就是 tasks.json 没生成或输出路径和 launch.json 对不上。
code 命令打不开？PATH 或 desktop 文件权限问题
即使 apt 安装成功，终端输 code 报 command not found 很常见，原因很具体：
- 首次安装后未重启终端（
code是通过修改$PATH注入的，新开终端才生效） - 用了
sudo code启动过一次，导致~/.vscode所有者变成 root，后续普通用户无法写入扩展目录 —— 运行sudo chown -R $USER:$USER ~/.vscode修复 - 桌面环境是 Wayland（如 Ubuntu 22.04+ 默认），某些老插件或调试器会静默失败 —— 可临时切 Xorg 登录（登录界面右下角齿轮图标）验证
最易被忽略的是：VS Code 的 code 命令本质是 shell 脚本，位于 /usr/bin/code，它依赖 /usr/share/code/bin/code。如果这个路径被误删或权限异常（比如被 chmod 700 过），code 就彻底失联，重装也无效 —— 此时应手动删掉 /usr/share/code 并重装 code 包。
