VS Code的大纲视图依赖语言服务器（LSP）提供符号信息，若文件类型识别错误、对应语言扩展未安装或配置不当（如tsconfig.json有误），Outline将为空；折叠功能受语言支持、缩进规范及自定义标记配置影响，需正确设置foldingStrategy和文件关联。
VS Code 默认支持代码折叠和大纲视图，但能否正常工作取决于语言支持、文件类型识别和扩展配置——不是所有文件都自动启用，也不是所有语法都能被正确解析。
为什么 outline 不显示或为空？
大纲视图依赖语言服务器（LSP）提供的符号信息。如果当前文件没被识别为对应语言，或语言扩展未安装/未激活，Outline 面板就只会显示“无符号”。
- 检查右下角状态栏：确认文件类型是否正确（如显示
Plain Text而非TypeScript），点击可手动切换 - 确保已安装对应语言扩展（如
ESLint不提供大纲，但JavaScript and TypeScript Nightly或官方TypeScript扩展会） - 某些自定义文件后缀（如
.vue、.astro）需额外配置"files.associations"，否则 LSP 不加载
如何让 folding 支持自定义区域或注释标记？
VS Code 原生支持基于缩进、括号和特定注释的折叠，但默认只识别 #region / #endregion（在 TypeScript/JavaScript 中），其他语言需显式配置。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 在
settings.json中添加语言专属折叠规则，例如 Python 可用：
"python.foldingStrategy": "indentation", "editor.folding": true, "editor.showFoldingControls": "always"
- 启用自定义折叠标记：设置
"editor.foldingStrategy": "auto"后，部分语言（如 Rust、Go）会响应// #region注释；但多数需扩展支持（如Custom Folding插件 + 正则配置） - 注意：缩进折叠（
indentation）对 YAML/TOML 有效，但对 JS/TS 可能误折叠函数体——此时应优先用auto
Ctrl+Shift+[ 折叠失效？检查这三项
快捷键失效通常不是 VS Code 本身问题，而是冲突、作用域限制或语言特性导致。
- 确认光标位于可折叠区域内部（如函数体内、类定义中），而非空行或注释行
- 检查快捷键是否被其他扩展覆盖：
Ctrl+Shift+P→ 输入Preferences: Open Keyboard Shortcuts (JSON)，搜索editor.fold查看绑定 - 某些语言（如 Markdown）默认禁用折叠；可在设置中强制开启：
"markdown.preview.breaks": false不影响，但需确保"editor.folding": true全局启用
真正容易被忽略的是：大纲视图中的符号层级由语言服务器决定，而非 VS Code 渲染逻辑——哪怕你写了正确的 export function，若 TypeScript 项目没配好 tsconfig.json 或类型检查报错，符号也可能不出现。折叠同理，缩进错误或混合空格/Tab 会导致折叠范围错乱。
