code --install-extension 命令需先将 code 加入 PATH，Windows/macOS 须通过命令或软链配置，Linux 需确认已执行 ./code --install-server；离线安装须用无空格英文绝对路径并加引号；批量安装需加 sleep 避免文件锁；安装后未生效需检查激活事件与工作区信任设置。
code --install-extension 命令必须先确保 code 在 PATH 中
运行 code --install-extension 报错 command not found 是最常见卡点。VSCode 安装时默认不把 code 命令写入系统 PATH，尤其在 Windows 上用 ZIP 免安装版、或 macOS 未勾选“Shell Command”时必然失败。
- Windows：打开 VSCode →
Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行 - macOS：同上命令，或手动软链：
sudo ln -s "/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code" /usr/local/bin/code - Linux：检查是否已执行过
./code --install-server（便携版需额外步骤）
验证是否成功：which code（macOS/Linux）或 where code（Windows）应返回有效路径。
离线安装 .vsix 时路径和空格必须处理干净
code --install-extension 对路径敏感，尤其 Windows 下带空格或中文的路径极易失败，错误信息常为 ENOENT 或静默退出。
- 绝对路径推荐用双引号包裹，且避免用户目录名含空格（如
"C:\Users\John Doe\.vscode\extensions\my.vsix"） - 更稳妥做法：把
.vsix文件放到无空格纯英文路径下，例如D:\ext\python.vsix，再执行code --install-extension "D:\ext\python.vsix" - 不要用相对路径加
./启动 —— 当前工作目录切换后会失效；code进程启动后 cwd 不一定继承你终端的路径
批量安装多个 .vsix 时注意顺序与依赖
有些扩展（如 ms-python.python）依赖其他扩展（如 ms-toolsai.jupyter），但 code --install-extension 不自动解析依赖，也不会报错提示缺失。
- 先装基础语言支持（如 Python、TypeScript），再装上层工具（如 Pylance、Jupyter）
- 批量脚本建议加
sleep 1间隔，避免并发写 extensions 目录引发文件锁冲突（尤其在 CI 环境中） - 示例（Linux/macOS）：
for f in *.vsix; do code --install-extension "$f"; sleep 1; done
安装后不生效？别只重启窗口，先查加载状态
插件装进去了，不代表它被激活了。很多扩展要满足 activationEvents 才真正加载，比如打开 .py 文件、调用某条命令，或等编辑器完全就绪。
- 打开命令面板（
Ctrl+Shift+P），输入Developer: Show Running Extensions—— 这里列出的是当前已激活的扩展，不是“已安装”列表 - 如果目标扩展没出现在该列表，说明它还没触发激活条件；尝试打开对应类型文件，或手动执行它注册的命令（如
Python: Select Interpreter） - 若仍不加载，检查输出面板（
Ctrl+Shift+U）→ 切换到Extension Host，看是否有Failed to activate extension报错
真正麻烦的不是装不上，而是装上了却不动——因为 activationEvents 写得严，或者 workspace trust 没开，这些细节不会在安装阶段暴露，得进运行时才浮现。
