code --disable-extensions 是唯一真正有效的安全模式启动方式,它在主进程初始化前切断扩展注册链路,不读 settings.json、不触发 activate()、不加载推荐扩展。

code --disable-extensions 是唯一真正有效的安全模式启动方式
VSCode 没有 GUI 可点的“安全模式开关”,所谓安全模式,本质就是跳过所有扩展加载流程。只有 code --disable-extensions 能做到这点:它在主进程初始化前就切断扩展注册链路,不读 settings.json、不触发任何插件的 activate()、也不加载工作区推荐扩展。其他方式——比如设置页里点“禁用全部扩展”——只是把状态写进配置文件,等 VSCode 已经跑起来才去读,对早期注入型插件(如旧版 ms-python.python 或 esbenp.prettier-vscode v9.x)完全无效。
为什么加了 --disable-extensions 还可能出问题
常见错误是以为只要带参数就行,忽略了路径和启动上下文的影响:
- 双击文件夹图标启动,即使加了
--disable-extensions,仍可能读取该目录下的.vscode/extensions.json或启用推荐扩展 - Windows 用户从开始菜单右键“以管理员身份运行”,会绕过所有命令行参数,
--disable-extensions彻底失效 - 路径含空格或中文时没加引号,例如
code --disable-extensions ~/my project会被 shell 截断为两个参数,VSCode 收到的是无效路径 - 用
code --disable-extensions .在子目录下执行,实际打开的是当前子目录,不是你预期的项目根目录
真正干净的安全模式启动组合
要排除一切干扰,得控制三个变量:扩展、用户配置、GPU 渲染。推荐按需叠加:
- 最简排查:在终端中先
cd /path/to/project,再执行code --disable-extensions(开空窗口)或code --disable-extensions .(开当前目录) - 进一步排除 GPU 或沙箱问题(黑屏/闪退):
code --disable-extensions --no-sandbox --disable-gpu - 彻底隔离用户配置(防 settings.json 残留干扰):
code --disable-extensions --user-data-dir /tmp/vscode-test - Linux/macOS 下避免波浪线解析失败:别用
~/project,改用绝对路径或先cd
验证是不是扩展导致的问题
核心逻辑只有一条:同一台机器、同一 VSCode 版本、同一文件、同一打开方式,唯一变量是是否加 --disable-extensions。
- 安全模式下问题消失 → 基本锁定为扩展问题,下一步用二分法:新建空扩展目录
/tmp/empty,执行code --disable-extensions --extensions-dir /tmp/empty,再逐步复制一半扩展进去测试 - 安全模式下问题仍在 → 打开
Developer: Toggle Developer Tools,看 Console 是否有Uncaught Error,或检查底部状态栏是否卡在Starting extension host...;注意某些插件(如Live Server)会把格式化规则写进用户级settings.json,即使禁用扩展,editor.formatOnSave的残留也会导致行为异常,但日志却显示“编辑器自身问题”
真正容易被忽略的点是:工作区信任机制(Restricted Mode)和扩展禁用是两回事。右下角显示 Restricted Mode 是因为文件夹未被信任,跟 --disable-extensions 无关;它禁用的是终端、调试器、任务运行器,不是扩展本身。











