注释字体不能只靠config.cson配置,因Atom将注释样式归于语法主题层,config.cson中的fontFamily仅影响编辑区整体排版,对.syntax--comment等选择器无效;需通过styles.less修改.atom/styles.less文件,使用atom-text-editor.editor .syntax--comment选择器,设置font-style: normal、font-family及color等属性,并注意字体名加单引号、编码为UTF-8无BOM、语法主题已启用且无插件冲突。

注释字体为什么不能只靠 config.cson 配置
因为 Atom 把注释样式归在语法高亮(Syntax Theme)层,config.cson 里设的 fontFamily 只影响编辑区整体排版,对 .syntax--comment 这类语法类选择器完全无效。你改了编辑区字体,注释还是用主题自带的默认样式——比如 one-dark-syntax 默认让注释斜体+浅灰,中文显示发虚,就是这个原因。
怎么用 styles.less 单独调注释字体和颜色
打开 Atom → Stylesheet…,编辑 ~/.atom/styles.less,贴入对应规则:
-
atom-text-editor.editor .syntax--comment是注释的准确选择器,别漏掉.editor和双连字符-- - 加
font-style: normal关掉斜体,中文才不会变形 - 用
font-family: 'Fira Code', 'JetBrains Mono', monospace—— 字体名必须单引号包裹,且和系统注册名一致(比如 macOS 上是Fira Code,不是FiraCode) - 配
color: #888或#666比默认#999更易读;font-size: 14px比正文小一号更协调
哪些字体真适合写注释,尤其含中文时
不是所有等宽字体都扛得住中英混排。实测下来这三类最稳:
-
Fira Code:连字友好,中文 fallback 到系统默认字体时过渡自然,但需确认已安装「Fira Code Regular」而非仅「Retina」变体 -
JetBrains Mono:专为开发者设计,中文标点宽度统一,font-feature-settings: "liga" 1, "ss01" 1对// TODO这类注释连字支持更好 -
Source Han Code JP(思源黑体编程版):开源、免费、中日韩全支持,注释里夹杂日文或 emoji 也不乱码,但文件体积稍大
别用 Consolas 或 DejaVu Sans Mono——它们没嵌入 CJK 字形,注释里一出现中文就 fallback 成方块或异常缩放。
改完不生效?先查这三处硬伤
常见静默失败点:
-
styles.less编码不是 UTF-8(无 BOM),Windows 记事本保存默认带 BOM,Atom 直接忽略整段规则 - 选错语法主题:装了
one-dark-ui但没配one-dark-syntax,注释样式根本没加载 - 插件覆盖:比如
highlight-line或minimap有时会强行重设.syntax--comment的 color,得在 styles.less 里加!important(仅当必要时)
改完保存,Atom 实时重载,不用重启——但如果刚从终端执行 atom . 启动,可能缓存旧配置,建议用 Dock 图标或菜单启动一次再试。

















