VSCode需装Markdown All in One插件并正确配置才能生成有效目录：确保语言模式为Markdown、标题格式合法（#至######）、光标置于合适位置；中文跳转失效需设slugifyMode为github；updateOnSave仅更新已有TOC块，首次须手动执行命令；侧边栏大纲需开启explorer.experimental.showOutline和outline.automaticCollapse为false。
VSCode 本身不生成 Markdown 目录，必须靠插件实现；但装了插件不等于目录就能自动跳转、实时更新——关键在配置和使用习惯。
Markdown All in One 的 Create Table of Contents 怎么用才有效
这个命令不是“点一下就完事”，它依赖两个前提：文档里有合法标题（# 到 ######），且光标落在合适位置（比如空行或 [TOC] 占位符处）。
- 如果文档里标题用了中文或特殊符号，生成的锚点 ID 可能被 GitHub 或预览插件截断（如
第一章:VSCode Markdown目录功能概述→第一章vscode-markdown目录功能概述），点击跳转会失败 -
Create Table of Contents默认只生成一级到三级标题，想包含四级及以上，得提前在设置里改markdown.allInOne.tocLevels（值设为4或6） - 生成后别手动删空行或改缩进——插件靠识别
- [xxx](#xxx)模式来判断这是 TOC 区域，格式一乱，后续Update Table of Contents就失效
为什么点击目录项没反应？检查这三处
常见假象是“目录生成了但点不动”，其实问题常不在插件本身，而在环境或配置。
- VSCode 内置预览（
Ctrl+Shift+V）支持跳转，但右键“Open Preview to the Side”打开的独立窗口有时不响应点击——换回内置预览再试 - GitHub 网页渲染时，中文标题生成的 ID 会被转成拼音+数字（如
兼容性说明→兼容性说明-1），而插件生成的链接还是原始 ID，导致 404；解决办法是加配置markdown.extension.toc.slugifyMode设为github - 如果用了
Markdown Preview Enhanced插件，它的预览和 TOC 是独立系统，和Markdown All in One不互通——别混着用，选一个主力插件到底
files.exclude 和目录生成的关系容易被忽略
插件扫描标题时，只读取当前工作区中未被排除的文件。如果你在 settings.json 里写了 "files.exclude": {"**/node_modules": true}，那没问题；但若误加了 "**/*.md": true，整个目录生成功能就静默失效——不会报错，只是不干活。
- 检查方法：打开命令面板，运行
Developer: Toggle Developer Tools，切到 Console 标签，生成目录时看有没有Failed to read file类报错 - 多文件夹工作区下，
files.exclude是全局生效的，但每个文件夹可有自己的.vscode/settings.json，记得确认作用域 - 某些主题插件（如
vscode-icons）不影响目录逻辑，但会遮挡标题前的图标，让层级视觉判断变难——这不是 bug，是图标覆盖了 Markdown 的#渲染间距
真正卡住人的，往往不是“怎么生成目录”，而是“为什么生成了却跳不到”或者“改了标题目录没更新”。这些问题基本都落在锚点规则、预览环境、文件可见性这三个交界点上，而不是插件装没装对。
