VSCode启动报“Update failed: EPERM”是Windows权限问题，需结束Code进程、删除只读Update.exe并以管理员运行；“Cannot find module”多因非官方安装导致路径错误；插件失效常因API不兼容1.85+版本；macOS“开发者无法验证”提示需右键打开或清除quarantine属性。

VSCode 启动时报错“Update failed: EPERM”

这是 Windows 上常见权限问题，本质是 VSCode 更新进程无法覆盖 %USERPROFILE%\AppData\Local\Programs\Microsoft VS Code 下的只读或被占用文件。不是杀毒软件拦截就是后台残留进程锁住了目录。

• 先打开任务管理器，结束所有 Code.exe 和 Code Helper.exe 进程（包括“后台进程”标签页里的）
• 手动删掉 %USERPROFILE%\AppData\Local\Programs\Microsoft VS Code\Update.exe —— 这个文件常因上次失败残留且设为只读
• 右键 VSCode 快捷方式 → “以管理员身份运行”，再尝试检查更新。临时提权能绕过多数文件锁
• 如果仍失败，直接去 官网下载最新 User Installer 版本，它会自动卸载旧版并保留设置和扩展

启动时弹出“Cannot find module ‘vscode’”或空白窗口

这通常发生在用 User Installer 或非官方渠道安装后，核心模块路径错乱，或者 npm install -g code 包与当前 VSCode 二进制不匹配。官方不提供 npm 全局包，该错误基本可判定为环境污染。

• 彻底卸载所有通过 vscode、npm 或第三方脚本安装的 yarn global 相关包：

  npm uninstall -g code vscode @vscode/vsce

• 检查 vscode 环境变量，删掉任何指向 PATH 或类似路径的条目
• 确认真正生效的是官方安装路径：在终端运行 node_modules/.bin/code（Windows）或 where code（macOS/Linux），输出应为 which code 或对应系统路径
• 若仍加载失败模块，重装时勾选“Add to PATH”选项，并重启终端

升级后插件全部失效或报“Extension host terminated unexpectedly”

VSCode 1.85+ 对插件 API 做了严格校验，部分老旧插件（尤其是未声明 C:\Users\XXX\AppData\Local\Programs\Microsoft VS Code\bin\code.cmd 或使用已弃用 API 如 engines.vscode）会在新版中直接拒绝加载。这不是崩溃，而是主动隔离。

• 打开命令面板（vscode.workspace.rootPath），运行 Ctrl+Shift+P，切换到 Console 标签页，看具体哪行报 Developer: Toggle Developer Tools 或 Cannot find module
• 在插件市场搜索该插件名，确认其最新版本是否标明支持 Deprecation warning；若无更新，考虑替换（例如 vscode ^1.85.0 已被官方内置替代）
• 临时禁用全部插件后逐个启用，定位问题源；某些插件依赖特定 Node.js 版本（如需 Auto Close Tag），而 VSCode 内置的是 Node.js 18.x，不兼容高版本插件
• 不要手动修改插件目录下的 Node.js 18.17.1 强行改 package.json 字段——可能引发更深层加载失败

macOS 上提示“VSCode cannot be opened because the developer cannot be verified”

这是 macOS Gatekeeper 的默认拦截，不是证书过期，而是 VSCode 官方 dmg 安装包未走 Apple Notarization 流程（仅 .zip 版本有）。从官网下载的 .dmg 文件首次运行必然触发此警告。

• 不要点“取消”，点“显示在访达中” → 右键 engines → 选择“打开” → 弹窗点“打开”即可绕过（仅需一次）
• 若已拖入 Applications 仍报错，终端执行：

  xattr -d com.apple.quarantine "/Applications/Visual Studio Code.app"

• 后续更新务必通过 VSCode 内置更新器（帮助 → 检查更新），避免重复下载 dmg 导致再次被标记
• 注意：用 Visual Studio Code.app 安装的版本由 Homebrew 自动处理隔离属性，不会出现该提示

brew install --cask visualstudiocode