VSCode目录链接点击无效，主因是锚点未生成而非链接错误；常见原因包括标题语法不规范、语言模式非标准Markdown、插件冲突或未激活，且目录为静态生成需手动更新。
VSCode里点不动的目录链接，先别怪插件
VSCode 内置预览不检查链接有效性，它只渲染语法、生成锚点、响应点击——但不会验证 #背景 这个锚点是否真有对应标题。所谓“跳转失败”，90% 是锚点没生成出来，不是链接坏了。
常见表现：点击目录项页面不动、滚动偏移、跳到顶部、或干脆无反应。原因基本就三类：
- 标题语法不规范：比如
## 二级标题（末尾有全角空格）、# 1. 简介（数字+点后跟空格，部分插件会忽略）、含 emoji 或不可见 Unicode 字符 - 语言模式没切对：右下角显示
Plain Text或Markdown (GitHub)而非标准Markdown，会导致markdown-all-in-one不触发锚点解析 - 插件未激活或冲突：多个 Markdown 插件（如
Markdown Preview Enhanced和Markdown All in One）同时启用时，可能互相劫持预览逻辑，锚点 ID 生成规则不一致
用 markdown-link-check 检查外部链接和文档内锚点
markdown-link-check 能扫 .md 文件里的所有链接，包括 [简介](#简介) 这种内部锚点——但它不是靠 VSCode 渲染结果判断，而是解析原始文本 + 模拟锚点生成规则，再比对目标是否存在。
执行前确保：
- 已全局安装：
npm install -g markdown-link-check - 文件中锚点名与实际标题严格匹配（小写、连字符替换空格、无标点）：标题
## API 响应格式→ 锚点#api-响应格式，不是#api-响应格式-或#API-响应格式 - 运行命令时工作目录是项目根，否则相对路径解析可能出错
示例命令：
markdown-link-check README.md --quiet
输出中若出现 → Not found: #xxx，说明该锚点在文档中无对应标题；→ Status: 200 表示外部链接可达。
VSCode 内实时验证锚点是否生成成功
不用跑命令、不依赖插件，直接看 VSCode 怎么“理解”你的标题：
- 把光标放在任意标题行（如
### 数据结构），按Ctrl+Shift+P打开命令面板，输入Copy Header Link—— 如果能成功复制类似https://example.com/#数据结构的链接，说明锚点已生成；如果报错或没反应，就是标题未被识别 - 打开命令面板，运行
Developer: Toggle Developer Tools，切换到 Console 标签页，刷新预览窗口，观察是否有警告如Failed to resolve anchor "xxx" - 在预览窗口右键 →
Inspect Element，找到目录项的<a href="#xxx">，再搜页面里是否存在<h3 id="xxx">—— ID 不一致就是锚点转换失败
为什么改了标题，目录跳转还是不对？
目录本身是静态生成的，不是实时绑定。你用 Markdown All in One 插件插入的目录，本质是一段手动写的 Markdown 链接列表，例如：
[简介](#简介) [配置说明](#配置说明)
它不会自动更新。所以：
- 新增/删改标题后，必须重新运行
Create Table of Contents命令覆盖旧目录 - 不要手动修改目录里的
#xxx部分，除非你同步改了对应标题的锚点 ID（建议靠插件自动生成） - 如果用了
Markdown Preview Enhanced，它的目录是动态渲染的，但依赖自己的锚点规则（比如默认转义中文更激进），和原生预览不兼容——别混用
最易被忽略的一点：VSCode 对中文标题生成锚点时，不同插件行为不一致，markdown-all-in-one 默认保留中文，markdown-preview-enhanced 默认转拼音或丢弃。跨插件协作时，锚点名根本对不上。
