Sublime Text支持快捷键切换语法高亮：Windows/Linux按Ctrl+Shift+P、macOS按Cmd+Shift+P调出命令面板，输入“Set Syntax:”后匹配准确语法名（如JavaScript、Vue Component）即可切换；语法名大小写敏感且须完整拼写；文件扩展名自动关联可能覆盖手动设置，可通过右下角点击语法名并选择“Open all with current extension as...”或在Syntax Specific配置中添加extensions字段解决；插件安装新语法后需重启或运行Reload Syntaxes命令刷新；部分功能（如括号匹配）依赖语法定义本身是否支持。

快捷键切换语法高亮模式最直接

Sublime Text 默认支持通过快捷键快速切换当前文件的语法高亮模式，无需鼠标点选菜单。Windows/Linux 按 Ctrl+Shift+P 调出命令面板，macOS 用 Cmd+Shift+P；输入 Set Syntax:（注意冒号），再输入语言名如 Python、JSON、Vue 即可实时匹配并切换。

语法名称必须拼写准确，大小写敏感

Sublime 的语法识别依赖于内置或插件安装的 .sublime-syntax 文件名，比如：

• JavaScript（不是 js 或 Javascript）
• Markdown（不是 md）
• Vue Component（官方 Vue 插件提供，不是 Vue）
• Shell-Unix-Generic（带连字符，不能省略）

输错会找不到选项，或误选到类似但不匹配的语法（如选了 Plain Text 导致高亮全失效）。

java-api-doc-generator

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

下载

文件扩展名自动关联可能覆盖手动设置

即使你手动切成了 YAML 高亮，如果文件后缀是 .yml，下次打开仍可能被自动设回 YAML；但若后缀是 .conf，它默认绑定 Plain Text，就得每次手动切。解决办法：

• 右下角点击当前语法名（如 Plain Text），选择 Open all with current extension as...
• 在命令面板中运行 Settings – Syntax Specific，添加 "extensions": ["conf"] 到配置里
• 避免用通配符扩展名（如 *），否则可能干扰其他语言文件

插件扩展语法支持需重启或重载

装完 Package Control 的新插件（如 Babel、GraphQL、Rust）后，语法不会立刻出现在命令面板里：

• 确认插件已成功安装（菜单 Preferences → Package Settings 中能看到对应项）
• 部分插件需重启 Sublime 才能注册语法（如旧版 Babel）
• 可手动触发重载：命令面板中运行 Reload Syntaxes（由 ApplySyntax 或原生支持提供）
• 检查插件是否自带 .sublime-syntax 文件，路径通常为 Packages/Babel/JavaScript (Babel).sublime-syntax

// 示例：在 Settings – Syntax Specific 中为 .env 文件启用 Shell 高亮
{
    "syntax": "Packages/ShellScript/Shell-Unix-Generic.sublime-syntax",
    "extensions": ["env"]
}

有些语法切换看似生效，但括号匹配、折叠或自动补全没跟上——那往往是因为底层语法定义本身不包含这些功能，不是切换操作的问题。