Code Outline 插件不显示大纲，主因是文件 languageId 未识别或符号解析被禁用；需确认语言模式正确、对应语言插件已启用、editor.codeOutline.enabled 为 true，并检查项目配置（如 tsconfig.json）及语言服务器状态。
Code Outline 插件安装后不显示大纲怎么办
插件装了但左侧没出现大纲面板，大概率是当前文件类型不被识别或符号解析被禁用。VSCode 的 Code Outline 依赖语言服务器提供符号信息，不是所有文件都能自动触发。
检查以下几点：
- 确认当前打开的文件有明确的
languageId（比如.ts文件应显示为 “TypeScript”，右下角状态栏可查看；若显示为 “Plain Text”，需手动点击切换） - 确保对应语言插件已安装并启用（如 TypeScript、Python、Java 等官方语言支持包）
- 检查设置中是否意外关闭了大纲：搜索
editor.codeOutline.enabled，确认值为true - 某些项目根目录缺少配置（如
jsconfig.json或tsconfig.json），会导致 TS/JS 文件符号提取失败
如何让 Code Outline 支持自定义文件类型（如 .ftl）
Code Outline 默认只支持 VSCode 内置语言和主流扩展注册的语言服务。像 .ftl 这类模板文件，需要额外声明语言关联和符号提供逻辑。
有两种可行路径：
- 在
settings.json中手动绑定文件关联："files.associations": { "*.ftl": "html" }（借用 HTML 解析器，适合结构简单、标签清晰的 FTL） - 更可靠的方式是配合语言扩展（如
FTL Language Support）——它必须实现DocumentSymbolProvider接口，否则Code Outline拿不到任何符号数据 - 如果已有 FTL 扩展但大纲仍为空，可在开发者工具（
Help → Toggle Developer Tools）中查看 Console 是否报错Unable to resolve provider for 'ftl'，这说明该扩展未注册符号提供器
大纲节点点击跳转失效或定位偏移
跳转不准通常不是 Code Outline 本身的问题，而是底层语言服务器返回的位置信息不精确。
常见诱因：
- 文件编码不是 UTF-8（特别是含 BOM 的 ANSI 文件），会导致行号计算偏差
- 使用了非标准换行符（如
\r单独存在），VSCode 解析行数时出错 - 语言扩展对注释块或宏语法（如 FTL 的
<#-- -->）处理不当，把注释区域误判为有效符号范围 - 编辑器启用了软换行（
editor.wordWrap: "on"），但大纲跳转仍按原始行号计算，视觉上看起来“偏了”
多人协作项目里大纲内容不一致
同一个文件，在 A 和 B 的机器上大纲节点数量或顺序不同，说明符号提取依赖本地环境变量或未提交的配置。
重点排查：
- 检查项目根目录是否有
jsconfig.json/tsconfig.json，且是否已提交到 Git —— 缺失时，TS/JS 文件可能降级为无类型解析 - 确认所有成员安装了相同版本的语言扩展（比如 Python 插件 v2025.x 对符号提取逻辑有改动）
- 留意工作区设置（
.vscode/settings.json）是否覆盖了全局的editor.codeOutline.showIcons或editor.codeOutline.showNumbers，影响显示但不影响功能 - 某些语言服务器（如 Rust 的 rust-analyzer）会缓存符号索引，清理
target/或重启语言服务器（命令面板执行rust-analyzer.restart）可同步状态
实际项目里最常被忽略的是语言服务本身的健康状态——大纲只是“显示器”，背后没有符号数据，再好的插件也白搭。调试时优先看右下角语言模式是否正确、Developer Tools 里有没有相关 Provider 报错，而不是反复重装插件。
