先执行Shell Command: Install 'code' command in PATH命令注册CLI，再重启终端验证；离线安装需加--allow-unverified参数绕过签名校验，路径含空格须用英文双引号包裹。
code --install-extension 命令报 command not found 怎么办
这不是 PATH 没配对，而是 VSCode 根本没注册 shell 命令。Windows/macOS/Linux 全部适用同一解法：
- 打开 VSCode（确保已启动）
- 按
Ctrl+Shift+P（macOS 是Cmd+Shift+P）唤出命令面板 - 输入
Shell Command: Install 'code' command in PATH，回车执行 - 关闭并重启终端，再运行
code --version验证是否生效
注意：该操作只在当前用户下生效；若用系统级安装的 VSCode（如 Windows MSI 版），可能需管理员权限重试。
装了 .vsix 却提示 INVALID_SIGNATURE 或静默失败
离线环境无法连接微软证书服务器校验签名，code --install-extension 默认会卡在这一步。必须显式绕过：
- 加
--allow-unverified参数，例如：code --install-extension python.vsix --allow-unverified - 路径含空格或中文？必须用英文双引号包裹：
code --install-extension "C:/my ext/python.vsix" --allow-unverified - Windows 下推荐用正斜杠
/而非反斜杠\，避免转义问题
不加这个参数，哪怕文件完全正确，也会失败且无明确错误提示——这是离线安装里最隐蔽的坑。
插件显示已安装但功能不生效
code --list-extensions 能看到 ID，不代表插件真在运行。常见原因不是安装失败，而是加载被跳过：
- 检查
package.json中的"engines": {"vscode": "^1.85.0"}字段，对比本地code --version输出（取前两位，如1.84.2→1.84），必须满足 ≥ 要求的最低版本 - 含 native binary 的插件（如 Pylance、ESLint server）必须匹配 CPU 架构：M 系 Mac 不能装
darwin-x64，得找darwin-arm64后缀的 vsix - 装完没彻底退出 VSCode：右下角托盘图标、后台进程都得杀干净，Windows 可用任务管理器结束所有
Code.exe
很多插件（比如 ms-python.python）依赖 ms-python.pylance，只装主包不装依赖，调试器根本起不来——这得靠解压 vsix 后查 extensionDependencies 字段确认。
批量安装时怎么避免漏掉隐式依赖
手动下载几个热门插件，跑起来就报错，大概率是依赖链断了。真正可靠的批量方案必须带依赖解析：
- 先在一台联网且已配好的机器上运行：
code --list-extensions > extensions.txt - 逐个下载对应 vsix 后，解压任意一个（
unzip -l prettier.vsix），打开根目录package.json - 重点看
extensionDependencies数组，例如："extensionDependencies": ["bradlc.vscode-tailwindcss"]，这个也得下、也得装 - 脚本化安装时，建议按依赖顺序排序后再执行
code --install-extension，否则部分插件初始化失败
依赖不是可选项，是运行前提。没它，esbenp.prettier-vscode 格式化会直接 fallback 到空逻辑，连报错都没有。
