VS Code 的括号匹配高亮和缩进指南线默认开启，但可能因语言模式错误、设置被禁用、主题颜色干扰、缩进不一致或语言服务器未加载而失效；需检查 editor.matchBrackets、editor.guides.indentation、语言模式及扩展状态。

VS Code 的括号匹配高亮和缩进指南线是默认开启的，不需要额外安装插件，但很多人没注意到它们其实可以被关闭、调细，甚至在某些语言或场景下失效——问题通常出在设置或语言模式上，而不是功能本身坏了。

括号匹配高亮不显示？检查 editor.matchBrackets 和语言模式

VS Code 默认启用括号高亮，但如果你在某个文件里看不到（比如打开一个无后缀的文本或 .log 文件），大概率是因为当前语言模式未被识别，导致相关功能未激活。

• Ctrl+Shift+P 打开命令面板，输入 Change Language Mode，确认右下角显示的是正确语言（如 JavaScript、Python，而非 Plain Text）
• 手动检查设置：搜索 editor.matchBrackets，确保值为 always（推荐）或 near；设为 never 会彻底禁用
• 部分语言扩展（如 Prettier、ESLint 插件）不会影响此功能，但极简主题（如 Minimal）可能把高亮色设成透明，可检查主题颜色设置中的 editorBracketMatch.background

缩进指南线（indent guides）为什么断断续续或不显示？

缩进线依赖编辑器对缩进结构的解析，不是单纯按空格/Tab画线，所以它会在注释块、字符串内、多行模板字面量中“消失”——这是正常行为，不是 bug。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• 确保 editor.guides.indentation 为 true（默认开启）
• 如果只在部分文件生效，检查该文件是否启用了 editor.renderIndentGuides 的覆盖设置（可通过右键状态栏缩进指示器切换）
• 缩进线对齐依据是 editor.detectIndentation 推测的缩进方式；若文件混用空格与 Tab，VS Code 可能放弃渲染指南线，建议统一为 2 或 4 个空格

想自定义括号高亮颜色或缩进线样式？改 workbench.colorCustomizations

VS Code 不提供 UI 设置入口来调这些颜色，必须手写 JSON 配置。缩进线本身没有独立颜色项，但括号匹配背景色可以精确控制。

• 在 settings.json 中添加：

{
  "workbench.colorCustomizations": {
    "editorBracketMatch.background": "#ffeb3b20",
    "editorBracketMatch.border": "#ffeb3b"
  }
}

#ffeb3b20 是带透明度的黄色背景（20 表示 12.5% 不透明），避免遮挡文字；纯色（如 #ffeb3b）容易看不清代码

缩进线颜色无法单独设置，它复用 editorRuler.foreground 或主题默认灰阶，强行改 ruler 颜色会影响垂直标尺，不建议

真正容易被忽略的点是：括号高亮和缩进线都依赖语言服务器（Language Server）提供的语法树信息。如果某个语言扩展崩溃或未加载（比如 Python 扩展卡在“Activating…”），这两项功能在该语言文件中就会静默失效——此时重启扩展或重装语言包比调设置更有效。