最稳方式是用系统包管理器安装：macOS用brew install --cask visualstudiocode，Ubuntu/Debian用sudo apt install code，Windows用choco install vscode或scoop install vscode，均自动配置PATH；手动下载易漏勾选“Add to PATH”，导致code命令不可用。
直接用系统包管理器安装最稳，别手搓
Windows/macOS/Linux 各自的官方渠道已经封装好依赖和路径注册，比手动下载安装包再配置 PATH 更可靠。跳过这步，后面 code 命令大概率不认。
- macOS（Homebrew）：
brew install --cask visualstudiocode，装完自动加入 PATH，code -v立即可用 - Ubuntu/Debian：
sudo apt update && sudo apt install code，源已由 Microsoft 官方维护，更新及时 - Windows（PowerShell 管理员权限）：
choco install vscode或scoop install vscode，二者都默认勾选“Add to PATH”
手动下载 .exe/.dmg/.deb 后双击安装，容易漏掉“将 VSCode 添加到 PATH”这个附加选项——结果就是命令行里敲 code 报错“不是内部或外部命令”，查半天才发现是安装时没勾。
批量静默安装 .vsix 扩展必须加 --force
企业部署或 CI 流水线里用 code --install-extension 装扩展，不加 --force 会失败，尤其当扩展已存在旧版本时。
- 错误现象：
Extension 'ms-python.python' is already installed.，脚本直接退出，后续扩展全跳过 - 正确写法：
code --install-extension python-2023.8.0.vsix --force，覆盖安装且不交互 - Linux/macOS 批量脚本示例：
for f in ./extensions/*.vsix; do code --install-extension "$f" --force done
注意：--force 不会降级，只覆盖同名扩展；如果想清空重装，得先 code --uninstall-extension 再装。
后台启动 VSCode 并自动跑服务，靠 tasks.json 不够
code --new-window . 能继承 shell 环境变量，但光这样不会自动执行 npm dev、sanity start 这类服务——VSCode 的任务调度要等语言服务就绪才触发，而命令行启动瞬间工作区还没加载完。
- 必须配全
tasks.json三要素："isBackground": true+"problemMatcher"（不能空）+"type": "shell" - 更关键的是进程驻留：VSCode 关掉后子进程默认被杀。Linux/macOS 得套
nohup npm run dev &；Windows 得用start /B npm run dev - 推荐健康检查兜底：
npx wait-on http://localhost:3000 && echo "Ready"，避免日志太快被误判为启动失败
漏掉 problemMatcher 或用 "type": "process"，任务面板一闪就退，连错误日志都看不到。
离线环境部署前，先确认 vsce download 能拿到指定版本
内网机器没法访问 Marketplace，得提前把 .vsix 文件拷过去。但 vsce download 默认只下最新版，而生产环境往往要锁版本。
- 先装工具：
npm install -g @vscode/vsce - 查可用版本：
vsce list-versions ms-python.python（部分扩展支持） - 指定版本下载：
vsce download ms-python.python --version 2023.8.0，生成ms-python.python-2023.8.0.vsix
有些扩展不开放历史版本下载，得去 GitHub Release 页面手动扒 .vsix，然后校验 SHA256——否则离线安装后发现功能缺失，排查成本远高于提前验证。
