Outline面板空白主因是语言服务器未正常返回符号数据或Markdown配置未启用；需检查LS状态、手动开启outline相关设置、确认UTF-8编码及纯ASCII井号，并更新TOC以匹配新slugify规则。
Outline 面板空白但文件语言模式正确？检查 language server 是否卡住
插件更新后大纲突然消失，常见于 TypeScript、Python 或 Java 插件升级后语言服务器（LS）未正常重启或返回空符号。VSCode 的 Outline 面板不依赖插件 UI 层，而是消费语言服务器通过 textDocument/documentSymbol 返回的数据。
验证方式：打开命令面板（Ctrl+Shift+P），运行 Developer: Toggle Developer Tools，在 Console 中执行：
vscode.languages.getLanguages().then(l => console.log(l))
再确认当前文档是否触发了符号请求：
vscode.workspace.onDidChangeTextDocument(e => { if (e.document.languageId === 'typescript') console.log('TS doc changed') })- 若
Output面板中切换到对应语言（如Python或TypeScript Server）显示 “Starting…” 卡住或报Cannot read property 'getSymbols' of undefined，说明 LS 初始化失败 - 重启语言服务器：右键状态栏语言名称（如 “TypeScript”）→
Restart TS Server - 临时禁用其他语言相关插件（如 ESLint、Prettier），排除冲突
Markdown 文件大纲不显示？别只盯插件，先看内置 outline 设置
VSCode 1.80+ 后，Outline 面板对 Markdown 的支持已从插件逻辑下沉为编辑器原生能力，但默认关闭。插件更新可能重置或覆盖用户设置。
关键配置项必须显式开启：
-
explorer.experimental.showOutline必须为true（控制侧边栏是否显示 Outline 图标） -
outline.automaticCollapse设为false，否则折叠后看不到内容 -
editor.codeOutline.enabled必须为true（旧版插件如 Code Outline 也依赖此项）
这些设置不会被 Markdown All in One 自动写入，需手动加进 settings.json。漏掉任意一项，Outline 面板都可能“存在但为空”。
标题解析失败但语法没错？检查文件编码与不可见字符
插件更新后更严格校验输入流，尤其对非 UTF-8 编码或含 BOM、零宽空格（ZWSP）、全角标点的文件，会导致解析器提前终止或跳过整段标题。
典型现象：大纲里只显示第一个 # 标题，后续全部消失；或中文标题显示但点击无响应。
- 用 VSCode 右下角编码指示器确认是
UTF-8，不是UTF-8 with BOM或GBK - 按
Ctrl+Shift+P→Toggle Render Whitespace，查看标题行首是否有隐藏缩进或 ZWSP（显示为·或︙） - 全角
＃（U+FF03）和 ASCII#（U+0023）在新版本解析器中不再兼容，必须替换 - 标题末尾空格、制表符、或混入 HTML 注释
<!-- -->也会导致该行被跳过
生成的目录链接跳转失效？插件更新改了 slugify 规则
Markdown All in One 等插件在 v3.10+ 后默认启用 github 模式的锚点生成，但旧项目仍沿用本地简化规则，造成跳转目标不匹配。
例如：## 配置说明（含示例） 在旧版生成 #配置说明含示例，新版生成 #配置说明含示例-1（因括号被过滤且去重）。
- 统一行为：在
settings.json中强制指定："markdown.extension.toc.slugifyMode": "github" - 确保
"markdown.preview.enableExtendedAutolinks"为true，否则预览内点击仍无效 - 重复标题现在会自动加后缀，但大纲面板本身不显示
-1，所以点击时实际跳转的是第 2 个同名标题——容易误判为“跳错了”
最易被忽略的是：插件更新后，它不再兼容你之前手写的旧锚点链接（如 [配置](#配置)），必须重新生成整个 TOC 块，不能只改个别链接。
