code命令不可用需先解决PATH和Shell Command注册问题；未勾选“添加到PATH”是主因，应通过命令面板运行“Shell Command: Install 'code' command in PATH”或手动配置bin路径并重启终端验证。
code 命令不可用？先解决 PATH 和 Shell Command 注册
离线批量安装的第一道坎，不是插件本身，而是 code 命令根本不存在。这不是权限问题，也不是路径写错，而是 VS Code 安装时没启用 CLI 集成。
System Installer 默认只在勾选“添加到 PATH(需要重启 Shell)”时才写入系统环境变量；User Installer 则只写入当前用户 PATH。如果跳过了这一步：
- 手动把
C:\Users\{username}\AppData\Local\Programs\Microsoft VS Code\bin（User Installer）或C:\Program Files\Microsoft VS Code\bin（System Installer）加进对应层级的 PATH - 重启 PowerShell/CMD，运行
where code验证是否返回路径 - 更稳妥的方式：打开已安装的 VS Code →
Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行（该操作会自动补全 PATH 并注册）
vsix 兼容性报错 “Extension is not compatible” 怎么办
错误信息如 Extension 'ms-python.python' is not compatible with VS Code 1.84.2，本质是插件 package.json 中的 engines.vscode 字段与本地 VS Code 版本不匹配——比如插件要求 "^1.85.0"，而你装的是 1.84.2。
别急着改 package.json 或硬装，优先做版本对齐：
- 在内网机器上运行
code --version，记下第一行完整版本号（如1.84.2） - 去 VS Code 官网历史版本页下载对应版本的安装包（
1.84.2而非最新版），重装主程序 - 在外网下载插件时，必须按此版本反向筛选：打开
https://marketplace.visualstudio.com/items?itemName=ms-python.python→ 点右侧 “Version History” → 找下载量 >500 万、且 Requirements 栏明确写 “VS Code >= 1.84.0” 的版本 → 点 “Download Extension” - 极少数情况需验证
.vsix内容：用 7-Zip 打开，检查根目录package.json的engines.vscode值是否真匹配
批量静默安装必须关闭所有 Code.exe 进程
code --install-extension 在后台启动 VS Code 实例来加载插件逻辑，若已有 GUI 进程在运行，它会卡住、弹窗、甚至静默失败——脚本看起来执行完了，但插件没装上。
企业部署脚本里必须前置强杀：
- Windows 下加一行：
taskkill /f /im Code.exe >nul 2>&1 - 再逐个执行：
code --install-extension D:\extensions\ms-python.python-2024.4.0.vsix --allow-unverified -
--allow-unverified必须带上：离线环境无法校验微软签名，否则报INVALID_SIGNATURE - 依赖插件不能漏：Python 插件实际依赖
ms-python.vscode-pylance、ms-vscode.js-debug等，必须从已配好的联网机导出完整列表：code --list-extensions > extensions.txt，再按行安装
怎么确保插件真的生效而不是“假装装上了”
装完就关终端、重启 VS Code，不代表插件已激活。很多插件（尤其是语言服务器类）会在首次打开对应文件类型时才真正加载，且可能因依赖缺失而静默降级。
验证环节不能跳：
- 重启 VS Code 后，按
Ctrl+Shift+P→ 输入Developer: Show Running Extensions，确认目标插件状态为 “Active”，而非 “Inactive” 或 “Blocked” - 打开一个
.py文件，看左下角是否出现 Python 解释器选择提示；点调试按钮，看是否弹出配置选项而非报错 “No debug adapter” - 检查插件是否被禁用：设置里搜
extensions.autoUpdate，确保为true；再搜extensions.ignoreRecommendations，设为false，避免被策略屏蔽 - 最易忽略的一点：插件安装后，其配置项（如
python.defaultInterpreterPath）不会自动继承，需统一推送settings.json模板
