markdown: create table of contents 命令无反应，主因是文件未被识别为 markdown 语言模式；需点击右下角手动切换为 markdown，并确认文件后缀为 .md，且在工作区中打开。
Markdown All in One 的 TOC 命令为什么没反应
插件装了但 Markdown: Create Table of Contents 命令执行后空白或报错，大概率是当前文件没被识别为 Markdown。VSCode 依赖文件后缀和语言模式双重判断——即使文件名是 README.md，如果右下角语言模式显示为 Plain Text 或 JSON，插件就不会响应。
解决办法很简单：
- 点击右下角语言模式标签，手动选
Markdown - 确认文件以
.md结尾（不是.markdown或其他变体） - 检查是否在工作区根目录下打开文件；某些配置只对工作区内的文件生效
如何让目录自动更新而不手动触发
Markdown All in One 默认不开启实时更新，需要显式启用。否则每次增删标题都得手动运行一次 Markdown: Create Table of Contents，反而更费事。
在 settings.json 中加这一行即可：
{
"markdown.extension.toc.autoUpdate": true
}
注意两点：
- 该设置仅对已存在
[TOC]或## 目录等标记的文件生效，新文件仍需首次手动插入 - 若文档含大量标题（>100个），开启后可能轻微卡顿，可配合
"markdown.extension.toc.levels": "1..4"限制深度
右键菜单里没有 File Utils 的选项怎么办
常见原因不是插件没装，而是 VSCode 没正确激活它。File Utils 插件依赖“资源管理器上下文菜单”扩展点，而这个点只在资源管理器聚焦时才加载。
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
验证和修复步骤：
- 确保资源管理器面板处于打开状态（快捷键
Ctrl+Shift+E） - 右键点击的是资源管理器里的文件/文件夹，不是编辑器标签页或空白区域
- 重启 VSCode 后仍无效？尝试禁用其他文件类插件（如
Project Manager），它们可能劫持了右键菜单
自动生成的目录链接跳转失败
点击目录项却跳不到对应标题，通常不是插件问题，而是 Markdown 锚点生成规则被破坏。VSCode 默认将标题转为锚点时会：
- 小写全部字符
- 用
-替换空格和中文标点 - 过滤掉特殊符号（如
?、!、（））
所以标题 ## 如何处理 HTTP 404 错误？ 对应的锚点是 #如何处理-http-404-错误，而非带问号的版本。若你手动写了链接，务必按此规则校验。
另外，如果标题含 emoji（如 ## ? 快速开始），部分旧版插件会忽略 emoji 导致锚点错位——升级到 Markdown All in One v3.12+ 可解决。
实际使用中，最易被忽略的是语言模式和上下文菜单的激活条件；功能本身很稳定，问题几乎都出在环境未就绪。
