code --install-extension失败的根本原因是code命令未注册到PATH，而非命令本身错误；需先通过Shell Command安装CLI或手动配置PATH，再确保用户对~/.vscode/extensions有写权限。
code --install-extension 是唯一可靠的方式，前提是 code 命令已正确注册到系统 PATH。不是所有机器默认支持，尤其在 Conda 环境、WSL 或最小化 Linux 发行版中，经常报 command not found。
为什么 code --install-extension 会失败
根本原因不是命令写错，而是 VS Code 的 CLI 工具没被系统识别：
-
code命令未加入 PATH（macOS/Linux 常见于未运行过“Shell Command: Install 'code' command in PATH”） - Conda 环境下 PATH 被覆盖，
source ~/.bashrc或source ~/.zshrc后仍需重新加载 shell - Windows 上若用 Scoop 或非标准路径安装，
code.cmd可能不在环境变量中 - VS Code 本身未完整安装（比如只解压了二进制但没执行初始化）
确认并修复 code 命令可用性
先验证是否真能调用：
code --version
如果报错，按系统类型处理：
- macOS：打开 VS Code →
Cmd+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行 - Linux（GNOME/KDE）：同上，或手动把
/usr/share/code/bin加入$PATH（写入~/.bashrc或~/.zshrc） - WSL：确保 Windows 版 VS Code 已启用“Remote - WSL”插件，并在 WSL 中运行
code --install-extension时使用 Windows 版本的 CLI（路径通常是/mnt/c/Users/{user}/AppData/Local/Programs/Microsoft VS Code/bin/code）
安装插件时的关键细节
命令本身简单，但参数和文件路径容易出错：
- 扩展 ID 必须精确匹配 —— 不是插件名，而是发布者.插件名格式，例如
ms-python.python，不是Python；可在插件市场页面 URL 或已安装插件的详情里找到 - 离线安装
.vsix文件时，路径必须是绝对路径或相对于当前 shell 工作目录的相对路径，不能带空格或中文（否则加引号也不一定可靠） - 批量安装建议用 shell 循环：
for ext in ms-python.python esbenp.prettier-vscode anthropic.claude-code; do code --install-extension $ext; done
- 某些插件（如
anthropic.claude-code）安装后需手动登录，--install-extension不触发授权流程
权限与静默安装的现实限制
chmod 644 解决不了核心问题，真正卡住的是用户权限模型和 VS Code 的沙箱机制：
- 不要用
sudo code --install-extension—— VS Code 拒绝以 root 运行 CLI 安装，会直接退出 - 如果提示
EPERM或EACCES，说明用户对~/.vscode/extensions/目录无写权限，运行ls -ld ~/.vscode/extensions
查看属主，必要时chown -R $USER:$USER ~/.vscode - CI/CD 场景下（如 GitHub Actions），需显式设置
CODE_WORKSPACE或用--user-data-dir指定临时配置路径，否则可能因权限或并发冲突失败
真正麻烦的从来不是敲哪条命令，而是你执行它时所在的 shell 环境是否真的认识 code，以及 VS Code 是否允许这个用户往自己的扩展目录里写东西。
