Notepad++中SQL文件/**块注释未按注释样式着色的原因及修改方法

阿华AIGC实验室

2026-5-15

SQL块注释颜色差异的原因及修改方法

Great question! Let's break this down clearly:

为什么两种注释颜色不同？

Most code editors and IDEs (like VS Code, IntelliJ DataGrip, or Sublime Text) treat these two block comment styles as distinct syntax elements:

/* Comment */ 被识别为常规块注释——是SQL里用于添加普通注释的标准格式。
/** Comment */ 则被标记为文档型注释（参考Java的Javadoc、Python的Sphinx文档注释风格），这类注释通常用于结构化说明存储过程、函数或表结构，甚至可以被工具解析生成文档。

你的编辑器默认会为这两类注释分配不同的语法高亮规则，所以才会出现颜色差异。

能不能修改这个设置？

当然可以！你可以把它们改成相同颜色，或者自定义成你喜欢的样式。下面是两款主流工具的修改方法：

VS Code

打开设置（Windows/Linux按Ctrl+,，Mac按Cmd+,）。
搜索editor.tokenColorCustomizations，点击"在settings.json中编辑"。
添加针对SQL文档注释的规则，比如让它和常规块注释颜色一致：

"editor.tokenColorCustomizations": {
    "textMateRules": [
        {
            "scope": "comment.block.documentation.sql",
            "settings": {
                "foreground": "#6A9955" // 替换成你常规块注释的颜色
            }
        }
    ]
}

如果你不确定常规注释的颜色或准确的作用域名称，可以通过Ctrl+Shift+P/Cmd+Shift+P调出命令面板，运行Developer: Inspect Editor Tokens and Scopes，鼠标悬停在注释上就能看到对应的语法作用域。

IntelliJ IDEA/DataGrip

打开File > Settings > Editor > Color Scheme > SQL（Mac上是Preferences）。
在左侧面板展开Comments分类。
你会看到两个选项：Block comments（对应/* ... */）和Documentation comments（对应/** ... */）。
选中Documentation comments，调整Foreground颜色和Block comments一致，点击Apply保存即可。