VSCode内置插件被禁用或激活失败时，应先执行Developer: Reload Window重置Extension Host；若无效，通过Developer Tools Console查activation错误，核对engines.vscode版本兼容性，必要时手动修复package.json或清理远端vscode-server。
内置插件被禁用或显示“Extension activation failed”
VSCode 的内置插件（如emeraldwalk.runonsave、ms-vscode.js-debug、ms-python.python等）不会出现在 Extensions Marketplace 搜索结果里，但可能因校验失败、版本不匹配或缓存错乱被静默禁用。典型表现是：命令面板搜不到对应命令（如Python: Select Interpreter）、调试按钮灰掉、右下角状态栏不显示语言模式图标。
不要卸载重装——内置插件无法通过 Extensions 视图卸载，强行删目录会导致启动报错。正确做法是重置其激活状态：
- 打开命令面板（
Ctrl+Shift+P），执行Developer: Reload Window，强制重建 Extension Host 进程 - 若仍无效，按
Ctrl+Shift+P输入Developer: Toggle Developer Tools，切换到 Console 标签页，搜索activation或failed，定位具体插件名和错误（如Cannot find module 'vscode'表示 API 版本不兼容） - 确认 VS Code 版本与插件要求一致：运行
code --version，再查该插件的engines.vscode字段（路径见下文）
手动修复被破坏的内置插件元数据
某些插件（尤其是 Remote-SSH、GitHub Copilot、Python）会在首次激活时写入本地配置或生成 runtime 文件。若中途崩溃，package.json 中的 engines.vscode 可能被意外覆盖为过低版本，或 extension.js 被截断。
操作前先完全退出 VS Code（Windows 查任务管理器中所有 Code.exe 和 Code Helper.exe；macOS 用活动监视器杀掉 Code 和 Code Helper (Renderer)）：
- 定位插件目录：
– Windows：%USERPROFILE%\.vscode\extensions\ms-python.python-2024.6.0\
– macOS/Linux：$HOME/.vscode/extensions/ms-python.python-2024.6.0/
（版本号随更新变化，可用ls -t $HOME/.vscode/extensions/ | head -5快速筛选） - 编辑该目录下的
package.json，检查"engines": { "vscode": "^1.118.0" }是否与你本地code --version输出的主版本兼容（例如你用的是1.118.0，就不能写成^1.117.0） - 保存后，**不要点「启用」**，而是重启 VS Code 并执行
Developer: Reload Window，否则变更不生效
Remote-SSH 类插件远端 server 不匹配
像 ms-vscode-remote.remote-ssh 这类插件，前端只是控制台，真正干活的是远端服务器上的 vscode-server。本地 VS Code 升级到 1.118.0 后，远端仍运行 1.117.0 的 server，就会卡在 Starting VS Code Server，且无明确报错。
这不是插件本身的问题，必须清理远端残留：
- 在远端机器（SSH 连接后）执行：
rm -rf ~/.vscode-server - 关闭本地 VS Code 窗口（确保所有 SSH 连接已断开）
- 重新打开文件夹并点击连接，VS Code 会自动下载并安装匹配的
vscode-server二进制（版本号与本地严格一致） - 注意：
~/.vscode-server/bin/下的 hash 目录名必须和本地code --version输出的 commit id 完全一致，否则仍会失败
离线重装内置插件的应急方案
当网络不可用、Marketplace 完全失效，或企业策略屏蔽了 marketplace.visualstudio.com，又急需恢复某个关键内置插件（如调试器）时，可跳过市场直装：
- 在另一台能联网的机器上，访问 https://www.php.cn/link/501a5397af4e433948303d2b70d49a08，点击右下角
Download Extension得到ms-vscode.js-debug-1.85.0.vsix - 把 .vsix 文件拷贝到目标机，**用命令行安装**：
code --install-extension "path/to/ms-vscode.js-debug-1.85.0.vsix"（Windows 路径含空格必须加引号） - 若提示
ENOENT，说明code命令未加入 PATH：在 VS Code 中按Ctrl+Shift+P，输入Shell Command: Install 'code' command in PATH并执行 - 安装后仍不生效？检查是否被
extensions.autoUpdate设置为false—— 临时设为true并重载窗口，让 VS Code 自动补全依赖
内置插件的 package.json 结构和普通插件一致，但它的 publisher 字段一定是 ms-vscode、ms-python 等微软官方前缀；改错字段或强行覆盖远端 server 二进制，比重装更危险。
