最可靠方式是使用 --disable-extensions 参数,它从启动阶段绕过扩展加载逻辑,跳过所有扩展(含语言服务器),不读取扩展目录,且需置于命令末尾。

VSCode 命令行启动时如何彻底禁用所有扩展
直接禁用全部扩展最可靠的方式是使用 --disable-extensions 参数,它会跳过所有已安装扩展的加载,包括那些设为“启用”的、工作区级启用的,甚至语言服务器类后台插件。这不是“禁用某个扩展”,而是让 VSCode 启动时不读取 ~/.vscode/extensions/(Linux/macOS)或 %USERPROFILE%\.vscode\extensions\(Windows)下的任何内容。
注意:该参数必须放在命令末尾,且不能与 --extensions-dir 混用(否则可能被忽略)。
- macOS/Linux:
code --disable-extensions /path/to/project
- Windows(PowerShell):
code --disable-extensions "C:\my\project"
- 若要同时禁用 GPU 加速(排查渲染问题常用组合):
code --disable-extensions --disable-gpu
为什么 --disable-extensions 比设置 "extensions.autoUpdate": false 更彻底
"extensions.autoUpdate": false 只控制自动更新行为,不阻止扩展加载;而 --disable-extensions 从进程启动阶段就绕过 Extension Host 初始化逻辑,连 package.json 的 activationEvents 都不会触发。这意味着:
- 不会出现“扩展正在激活…”的右下角提示
-
Developer: Toggle Developer Tools中看不到Extension Host进程内存占用 - 即使某扩展声明了
"*"激活事件,也不会运行其activate()函数 - 对性能敏感场景(如老旧设备开大仓库)效果明显——实测启动时间可减少 30%–60%
想临时禁用部分扩展而非全部?用 --extensions-dir 更可控
如果你只是想测试某个扩展是否引发崩溃,又不想卸载它,可以创建一个空目录并指向它:
- 新建临时空目录:
mkdir /tmp/vscode-no-ext(macOS/Linux)或mkdir C:\vscode-no-ext(Windows) - 启动时指定:
code --extensions-dir /tmp/vscode-no-ext /path/to/project
- 这样 VSCode 会把该目录当扩展根目录,因为空,所以等效于无扩展;你仍可手动复制单个
.vsix进去做定向验证
注意:--extensions-dir 不会清空原扩展目录,退出后一切照旧,比反复启停 --disable-extensions 更适合调试。
常见误操作和兼容性陷阱
很多人以为加 --disable-extensions 就万事大吉,但实际遇到问题常源于以下几点:
- 在 Windows 上双击快捷方式启动 VSCode,默认不走命令行,参数无效;必须通过终端或修改快捷方式目标字段(如添加
--disable-extensions到末尾) - 某些企业策略或组策略(GPO)可能强制启用特定扩展,此时
--disable-extensions会被覆盖——需检查Developer: Open Policy Settings输出 - Remote-SSH / WSL 等远程开发场景下,
--disable-extensions只作用于本地 VSCode 实例,远程端扩展仍会加载;需额外在远程配置中设"remote.extensionKind": {"publisher.name": ["ui"]}或改用--skip-getting-started配合远程禁用 - VSCode Insiders 版本中该参数行为一致,但 1.85+ 开始支持
--disable-extension单独禁用,ID 格式为publisher.name(如ms-python.python)
真正需要“无扩展模式”时,别依赖 UI 设置里的开关——只有命令行参数能保证从 loader 第一行代码起就切断扩展链路。










