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 控制台输出,而不是猜配置或重装系统。










