Ubuntu/Debian系统推荐用APT安装VS Code，因其自动解决libxkbfile1等依赖、签名可信；关键需动态获取架构（dpkg --print-architecture）、正确导入密钥、配置源路径，并在PATH缺失时手动软链/usr/bin/code。
直接装 code 命令能用，就说明安装成功；但多数人卡在「装完打不开」「code 命令未找到」「启动报错缺库」这三类问题上——核心不是“能不能装”，而是“装完能不能立刻用”。不同发行版、不同权限环境、不同网络条件，得选对路径，否则后续配 C++、SSH、MPI 全都会卡住。
Ubuntu/Debian 系统用 APT 仓库安装最稳
这是官方推荐方式，包签名可信、更新有保障，且自动解决 libxkbfile1、libglib2.0-0 等基础依赖。关键点在于密钥和源的路径必须严格匹配当前系统架构（amd64 或 arm64）。
- 先执行密钥导入：
curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/microsoft-archive-keyring.gpg - 再写源地址，注意
arch=$(dpkg --print-architecture)动态获取架构，别手敲成amd64硬编码（ARM 设备会失败） -
sudo apt update后如果提示 “The repository does not have a Release file”，说明源地址里stable写成了main或路径拼错了 - 装完运行
code --version，若报command not found，说明/usr/bin/code没被 PATH 收录，可手动软链：sudo ln -s /usr/bin/code /usr/local/bin/code
CentOS/RHEL/Fedora 用 RPM 包安装要补依赖
RPM 安装不走仓库，适合内网或离线环境，但缺依赖不会自动提示，而是直接启动失败。常见报错是 libXss.so.1: cannot open shared object file 或 libgconf-2.so.4 找不到。
- 下载地址用这个才稳定：
wget https://code.visualstudio.com/sha/download?build=stable&os=rhel-x64 -O code.rpm（别用浏览器点链接，容易下成 HTML） - 安装后先不急着启动，先检查缺失库：
ldd /usr/bin/code | grep "not found" - 典型缺失项：
sudo dnf install libXScrnSaver gconf2 atk at-spi2-atk gtk3（Fedora 36+ 可能还需libappindicator-gtk3） - 若仍报
GLIBCXX_3.4.29 not found，说明系统 GLIBCXX 版本太低，RHEL 8/CentOS 8 及以上基本无此问题；老系统建议换 Snap 或 tar.gz 方式
没 root 权限或想免污染？用 tar.gz 解压即用
这个方式不写任何系统路径、不改 /etc、不依赖包管理器，适合学生机、共享服务器、Docker 容器等受限环境。唯一代价是每次升级都要手动替换文件夹。
- 下载命令：
wget https://code.visualstudio.com/sha/download?build=stable&os=linux-x64 -O vscode.tar.gz - 解压到用户目录：
tar -xzf vscode.tar.gz -C ~/vscode - 启动方式：
~/vscode/Code --no-sandbox（加--no-sandbox避免无 CAP_SYS_ADMIN 权限时崩溃） - 想全局调用？在
~/.bashrc末尾加：alias code="$HOME/vscode/Code --no-sandbox"，然后source ~/.bashrc - 注意：插件默认存在
~/.vscode，和系统级安装不冲突，但远程开发扩展（如 Remote-SSH）需手动在该实例中重装
启动报错 ENOSPC 或文件监听失效
这不是 VSCode 装错了，而是 Linux inotify 限制太低，尤其在大型工程（如 OpenCV、ROS 工作区）中高频触发。错误信息通常是：Error: ENOSPC: System limit for number of file watchers reached。
- 临时缓解：
echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p - 别只改当前 session（
sysctl -w），必须写进/etc/sysctl.conf才永久生效 - 如果用的是 WSL2，这个参数要设在 Windows 的
%USERPROFILE%\AppData\Local\Packages\...\wsl.conf里，不是 Linux 子系统内 - VS Code 设置里关掉不必要的文件监听（
"files.watcherExclude"）比硬调系统参数更安全
真正麻烦的从来不是“怎么装”，而是装完发现 code 命令能跑、但 Remote-SSH 连不上，或者 C++ IntelliSense 找不到头文件——那往往是因为安装路径和用户环境变量没对齐，或者用了 Snap 却忘了加 --classic 权限。动手前先确认你到底需要什么：是本地写脚本？远程连服务器？还是嵌入式交叉编译？路径一错，后面全偏。
