VSCode默认启用受限模式,首次打开文件夹(如Downloads、Git克隆项目)自动标记为未受信,静默禁用插件、任务、调试、终端及语言服务;需点击右下角锁形图标选择“Trust This Workspace”并重载才能恢复全部功能。

VSCode 打开项目后功能大面积失效,不是插件崩了、环境没配好,而是被“受限模式”静默拦截了——必须手动授信才能恢复。
为什么点击预览、调试、格式化全没反应
这是 VSCode 1.56+ 的默认行为,不是 bug。首次打开一个文件夹(尤其是从 Downloads、Desktop、U 盘或 Git 克隆来的项目),它会自动标记为“未受信”,进入受限模式。此时:
-
Markdown Preview Enhanced点击预览无响应 -
tasks.json中的构建脚本不触发 - 终端里
npm install报“命令未找到”(其实是 shell 没加载$PATH) -
launch.json调试按钮灰掉,gopls/tsserver补全延迟或消失 -
ESLint不标红,Prettier快捷键失灵,GitLens 提交信息不显示
这些不是扩展坏了,是 VSCode 主动掐断了执行链路。关键线索在右下角状态栏:只要看到 Restricted Mode 或 Not trusted,就确认是信任问题。
如何立即恢复当前项目的所有功能
唯一可靠、即时生效的操作是手动授信并重载,而不是改配置、删缓存、重装插件:
- 点击 VSCode 窗口右下角的锁形图标或
Not trusted文字 - 选择
Trust This Workspace - 勾选
I understand the risks,然后点Trust and Reload
重载完成后,所有被禁功能(终端、任务、调试、语言服务、扩展后台进程)会立刻回归。注意:这个操作只影响当前文件夹,不会波及其他工作区。
怎样避免每次打开都弹窗确认
有且仅有两种实用路径,选哪个取决于你的使用场景:
- 对个人本地开发目录(如
D:\Projects\my-app或~/dev/react-admin)放心授信:直接点Trust and Reload,之后再打开同一路径就不会再弹窗 - 想全局跳过检查(仅限完全可控的离线开发机):打开设置,搜索
security.workspace.trust.enabled,设为false。但后果是——下载一个带恶意tasks.json的 GitHub 仓库,双击打开就可能静默执行任意命令
别试图用 security.workspace.trust.untrustedFiles 或 files.associations 绕过限制,它们不改变执行权限,只影响文件打开行为。
命令行打开项目时卡住或静默失败怎么办
VSCode 不提供 --skip-trust-check 这类参数。CI 脚本或自动化任务(比如用 code --goto 或 code --diff)遇到未信任路径,会卡住或无输出。可靠解法只有两个:
- 提前对目标路径授信:手动用 GUI 打开一次,点
Trust and Reload,之后命令行调用就正常了 - 改用绝对路径 + 已授信目录作为父级:比如把项目挪进已信任的
~/dev/下,再用code /Users/you/dev/my-project
真正容易被忽略的是:信任状态不继承子目录。你信任了 /project,再单独打开 /project/node_modules,它仍是未受信的——VSCode 把每个文件夹都当作独立工作区处理。


















