VS Code 每月更新需高效适配：Agent 模式需开关、工具注册、编辑权限三者齐备；AGENTS.md 必须置于工作区顶层且命名格式严格；后台任务应启用隔离 worktree；TS 7.0 预览版以状态栏标识为准。
VS Code 每月更新不是“要不要跟”，而是“怎么高效用上”——关掉自动更新反而增加维护成本，但盲目点“立即重启”又容易踩坑。
如何快速确认当前版本是否已启用 Agent 模式
很多人以为开了 chat.agent.enabled 就万事大吉，实际常因配置未生效或依赖项缺失导致 AI 不执行修改。Agent 模式本质是一套协同工作流，需三要素同时就位：开关开启、工具注册成功、编辑权限明确。
- 打开设置（
Ctrl+,），搜索并勾选chat.agent.enabled - 检查扩展视图右下角
MCP SERVERS区域，状态必须为Running；若显示Not connected，点击后查看日志末尾是否有Ready to serve tools - 关键安全项：
chat.tools.edits.autoApprove默认为false，不手动设为true，AI 提出的文件修改将卡在待确认状态，不会自动应用 - 终端命令默认不自动执行，如需放开，得单独设
chat.tools.terminal.enableAutoApprove，但强烈建议保持false——这是防止恶意提示注入的第一道闸
AGENTS.md 文件为什么没被识别
项目级上下文注入看似简单，但路径、命名、格式任一环节出错都会让整个文件失效。VS Code 只认根目录下的 AGENTS.md，且仅当工作区以文件夹形式打开时才加载。
- 文件必须放在当前工作区**最顶层目录**，不能嵌套在
docs/或.vscode/下 - 文件名严格为
AGENTS.md（全大写 A、G、E、N、T、S），大小写错误即失效 - 内容需为纯 Markdown 格式，首行必须是
role:或constraints:等有效字段，空行或注释开头会导致解析中断 - 修改保存后无需重启，但已有聊天窗口需新开一个才能加载新上下文——旧会话仍按原规则运行
后台智能体任务为何突然中断或冲突
1.107 版本起，后台代理默认在独立 Git worktree 中运行，但该行为需显式启用。若未勾选隔离选项，多个代理会直接操作同一工作区，轻则覆盖彼此修改，重则触发 Git 冲突甚至破坏暂存区。
- 发起耗时任务后，在响应末尾点击
Continue in background - 弹出面板中务必勾选
Run in isolated Git worktree，并输入有意义的名称（如api-refactor-202603） - 完成后不要直接合并，先切到该 worktree 目录，用
git status和git diff审查变更范围，再决定是否git merge - 误删 worktree？别慌——它只是个普通文件夹，只要没执行
git worktree prune，数据仍在磁盘上
TypeScript 7.0 预览版报错或无响应
VS Code 1.107 内置了 TypeScript 7.0 预览引擎，但它是可选启用项。状态栏显示 TypeScript 7.0 (Preview) 是唯一可靠判断依据，仅靠版本号或设置开关都不够。
- 打开任意
.ts文件，看右下角语言模式栏是否出现TypeScript 7.0 (Preview)；若显示TypeScript 5.4或其他版本，说明未激活 - 检查设置中
typescript.preferences.includePackageJsonAutoImports是否设为auto，该选项在 7.0 中影响自动导入性能 - 若启用后类型检查变慢，可能是插件冲突——禁用所有非必要 TS 相关扩展（如
ESLint的 TS 支持），再逐个启用排查 - 注意：TS 7.0 预览版暂不支持
declare module的某些高级泛型推导，遇到Type 'X' is not assignable to type 'Y'类型错误时，先回退到稳定版验证是否为新引擎 Bug
真正难的不是找功能在哪，而是搞清它和你现有工作流怎么咬合——比如 AGENTS.md 和团队共享规范的关系，或者后台 worktree 和 CI 流水线的兼容性。这些细节不写在更新日志里，但卡住你的时候，它就在那儿。
