插件更新后需手动重载窗口才能生效，否则调试、格式化等功能失效；cli安装可能跳过激活脚本，需重启gui或手动重载；建议禁用自动更新并注意离线环境依赖重建。
插件更新后调试失效，先查是否重载了窗口
VSCode 插件（尤其是语言服务器类，如 ms-python.python、esbenp.prettier-vscode）更新后，新代码不会自动生效——必须手动重载窗口。很多人点了“Update”就以为完事，结果断点不命中、格式化没反应、IntelliSense 仍报旧错。
常见现象包括：Debug Adapter exited with code=1、Failed to activate extension、右下角状态栏显示“Python Language Server starting…”但一直卡住。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并执行Developer: Reload Window - 若重载后仍异常，再试
Developer: Toggle Developer Tools，在 Console 中搜ExtensionHost或具体插件名，看是否有未捕获的启动错误 - 某些插件（如 ESLint）更新后会要求你确认是否启用新规则，默认可能禁用，需进其设置页手动开启
更新命令不触发 post-update 脚本？用 CLI 时得补一步
直接运行 code --install-extension ms-python.python 或 code --update-extensions 是静默覆盖式安装，它跳过插件定义的 activationEvents 和 scripts.postinstall —— 这些脚本常负责下载二进制依赖（如 Pylance 的 .dll 或 .so）、生成缓存目录、校验 license 等。
后果是：插件图标显示正常，但核心功能（如跳转定义、类型推导）完全不可用，且控制台无报错。
- 执行 CLI 更新后，务必再打开一次 VSCode GUI 窗口（哪怕只是空窗口），让插件有机会运行激活逻辑
- 更稳妥的做法：先用 CLI 安装，再用命令面板执行
Extensions: Show Installed Extensions，右键目标插件 →Reload Extension - Linux/macOS 用户注意：
code命令若由 root 安装，普通用户执行--install-extension可能因权限不足写入失败，报错EACCES: permission denied，此时改用sudo -u $USER code --install-extension ...
调试中插件突然升级，断点全丢？关掉自动更新
VSCode 默认开启 extensions.autoUpdate，但这个“自动”不是静默后台安装，而是：检测到新版 → 下载到缓存 → 下次重启时自动应用。问题在于，你正在单步调试一个函数，窗口突然弹出“重启并安装更新”，一确认，所有断点、调用栈、变量快照全清空。
这不是 Bug，是设计行为。尤其当你调试的是插件自身（比如开发一个自定义 Debugger Adapter），这种中断等于直接杀死调试会话。
- 立即关闭：设置中搜索
extensions.autoUpdate，设为false - 企业环境或 CI 流水线中，建议额外加一行配置：
"update.mode": "manual"，彻底禁用检查逻辑 - 别信第三方“Auto Update Extensions”插件——它们常绕过 VSCode 的更新队列，在任意时刻触发重载，2026 年主流版本基本已失效或引发兼容性崩溃
离线环境更新插件，.vsix 安装后还要手动清理 node_modules
在内网或代理受限环境，用 Extensions: Install from VSIX 安装下载好的 .vsix 文件是最可靠方式。但很多用户装完发现功能残缺：比如 Python 插件能识别语法，却无法启动调试器；Prettier 显示按钮但点不动。
根本原因是：VSCode 安装 .vsix 时，只解压主体代码，不重建 node_modules —— 而现代插件（尤其含本地模型或 WASM 模块的）严重依赖该目录下的预编译二进制。
- 找到插件安装路径：
~/.vscode/extensions/ms-python.python-2026.8.1（Linux/macOS）或%USERPROFILE%\.vscode\extensions\ms-python.python-2026.8.1（Windows） - 删除该目录下的
node_modules文件夹（如有） - 重启 VSCode，插件首次激活时会自动运行
npm install或等效逻辑重建依赖（前提是系统已装 Node.js） - 若无 Node.js，需提前在离线机上用相同架构/版本构建好
node_modules并打包进去
真正难处理的从来不是“怎么点更新”，而是更新后插件和编辑器之间的契约是否还成立——API 兼容性、依赖版本锁、本地缓存状态，三者只要一个错位，调试流程就断在你看不见的地方。
