code命令未生效需先确认PATH配置与权限：安装时须勾选“添加到PATH”，否则仅图形界面终端可用；若未勾选，需手动将VS Code的bin目录加入系统PATH并重启终端，再用where code验证。
code 命令没生效？先确认 PATH 和权限
离线部署时最常卡在这一步：执行 code --install-extension 报错“不是内部或外部命令”。这不是插件问题，而是 VS Code 本身没正确注册到系统路径。
安装时务必勾选“添加到 PATH（需要重启 Shell）”，否则 code 命令只在图形界面启动的终端里可用。如果已安装但未勾选：
- 手动把
C:\Users\{username}\AppData\Local\Programs\Microsoft VS Code\bin加进系统环境变量 PATH - 重启 PowerShell/CMD，再运行
where code验证是否找到 - 若用的是 System Installer 但当前是普通用户，
code默认写入的是系统级 PATH；User Installer 则只写入当前用户 PATH
vsix 安装失败报 “Extension is not compatible” 怎么办
错误信息通常是 Extension 'xxx' is not compatible with VS Code x.x.x —— 这不是版本号写错，而是 engines.vscode 字段不匹配。
VS Code 对插件有严格版本约束，比如 Python 插件 v2024.6.0 要求 "^1.85.0"，而你装的是 1.79.2 就会拒绝安装。解决方法：
- 用
unzip -l plugin.vsix（Linux/macOS）或 7-Zip 打开 .vsix，查看根目录下package.json的engines.vscode值 - 对照你内网机器上 VS Code 的版本：
code --version输出第一行 - 优先去 VS Code 官网历史版本页下载匹配的旧版 VS Code，而不是降级插件（很多插件旧版不再提供下载）
- 极少数情况可临时修改
package.json中的engines.vscode（不推荐，可能引发运行时异常）
批量静默安装插件：脚本必须绕过 GUI 交互
企业部署不能靠点鼠标，得用纯命令行 + 无提示方式。关键点在于：VS Code 启动时若检测到 GUI 环境，会弹窗或等待用户输入，导致脚本卡住。
真正静默的安装方式只有这一种：
- 确保目标机器没运行任何 VS Code 进程（
taskkill /f /im Code.exe） - 全部使用
code --install-extension命令，不要调用图形界面的“从 VSIX 安装…” - 路径必须用绝对路径，相对路径在服务账户或计划任务中会失效
- 加
--force参数强制覆盖已存在同名插件：code --force --install-extension D:\vsix\ms-python.python-2024.6.0.vsix - Windows 批处理示例：
for %%i in (D:\vsix\*.vsix) do code --force --install-extension "%%i"
插件依赖缺失导致启用失败，怎么提前发现
很多插件（如 ms-python.python）依赖 ms-toolsai.jupyter 或 ms-vscode.vscode-typescript-next，但 code --install-extension 不报错也不提示——它只装你指定的那个 vsix，不管依赖。
结果是插件列表里显示已安装，但启用时报错“依赖插件未找到”。预防方法：
- 在外网机器上用已配置好的 VS Code 导出完整依赖树：
code --list-extensions --show-versions > extensions.txt - 逐个检查每个插件的
package.json，看extensionDependencies字段 - 用
vsce ls（需 npm install -g vsce）解析 vsix 内容：vsce ls python.vsix | grep -i dependency - 内网安装后，用
code --status查看“Extensions:”部分，已启用但标红的，基本就是缺依赖
静默部署最易被忽略的环节，是以为装完所有 vsix 就万事大吉，其实插件间的隐式依赖链必须人工对齐，否则开发机一打开就报错。
