PhpStorm注释显示□□□是字体回退链断裂所致：TextMate引擎不自动fallback，必须在Editor→Font中显式配置逗号分隔的完整字体链（如Fira Code, Noto Sans CJK SC, Segoe UI Emoji），字体名须与系统安装完全一致，且改后必须重启IDE。
PhpStorm注释显示□□□，不是编码问题，是字体回退链断了
编辑器里中文注释变成方块，90%和文件编码无关，而是 PhpStorm 的 TextMate 高亮引擎在渲染注释时，只认 editor.fontFamily 里显式列出的字体，且不自动 fallback——它不会像系统或浏览器那样“悄悄换字体”，必须手动给全链路。
常见错误是只设了一个西文字体（比如 Fira Code），没加中文字体；或者加了但顺序错、名字拼错、漏了 emoji 字体兜底。
- 确认你当前
Settings → Editor → Font的Font family输入框填的是逗号分隔的完整链，例如：Fira Code, Noto Sans CJK SC, Segoe UI Emoji（Windows）或Fira Code, PingFang SC, Apple Color Emoji（macOS） - 字体名必须和系统实际安装名称完全一致：大小写、空格、连字符都不能错；可用系统字体管理器查证，别凭记忆写
Microsoft YaHei却装了Microsoft YaHei UI - Linux 用户注意：
Noto Sans CJK SC是推荐名，但 Debian/Ubuntu 上实际包名是fonts-noto-cjk，装完后字体名常为Noto Sans CJK SC或Noto Sans CJK，需实测 - 改完必须重启 PhpStorm，仅点
Apply不生效——这是 JetBrains 长期存在的缓存机制缺陷
为什么注释比字符串更早出方块？TextMate 渲染路径不同
字符串字面量（如 "用户名"）可能因语言服务 token 化过程触发系统级字体 fallback，而注释是纯正则匹配的静态文本，TextMate 引擎直接按 fontFamily 列表从左到右逐个尝试，第一个不支持中文的字体就卡住，立刻画 □。
也就是说：即使你代码里中文能显示，注释仍可能崩——这不是 bug，是设计如此。
立即学习“PHP免费学习笔记（深入）”；
- 别指望靠改
File Encodings → UTF-8解决注释方块，那是文件读取层，不影响高亮渲染层 - 别用
Settings → Editor → Color Scheme → Console Font来救注释，那个只管终端输出，和编辑器内注释无关 - 如果只改了
Appearance → Override default fonts，那只是菜单/状态栏变中文，对注释无效
Linux 下还要额外配 Java 字体映射，否则 UI 和提示也方块
Debian/Ubuntu/CentOS 上，PhpStorm 启动时用的是内置 JRE，它默认不认识中文字体路径。即使编辑器注释好了，菜单、Git 提交框、参数提示（Parameter Info）仍可能显示 □——这是 Java 层字体映射缺失。
核心动作是修改 JVM 的 fontconfig.properties 文件，让 Java 知道中文该 fallback 到哪。
- 先装字体：
sudo apt install fonts-noto-cjk（Debian/Ubuntu）或sudo yum install cjkuni-ukai-fonts（CentOS） - 找到 PhpStorm 使用的 JRE 目录：Help → About →
JRE路径，进入jre/lib/ - 备份并编辑
fontconfig.properties，确保有类似内容：sequence.allfonts.UTF-8.zh.CN=latin-1,chinese-cn-iso10646<br>sequence.fallback=chinese-cn-iso10646,sansserif
- 在
filename.-misc-noto-cjk-medium-r-normal--*-%d-*-*-p-*-iso10646-1行指向实际字体路径，例如：/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc - 改完保存，必须重启 PhpStorm，Java 层配置不热加载
emoji 和中文标点混排时歪斜？连字字体和中文字宽冲突
用 Fira Code 这类连字字体时，中文标点（如顿号、引号、括号）容易错位、重叠或光标偏移——这不是设置错误，是西文连字字体对全角字符 baseline 和字宽处理不兼容。
解决思路不是调 line-height 或 kerning，而是分层指定字体：前段保连字，中段保中文对齐，末段兜 emoji。
- 推荐组合：
Fira Code, HarmonyOS Sans SC, Segoe UI Emoji（Windows）、Fira Code, Noto Sans CJK SC, Apple Color Emoji（macOS） -
HarmonyOS Sans SC和Noto Sans CJK SC是等宽中文字体，字宽与主流编程字体对齐，能避免标点“漂”或“挤” - 别把
Segoe UI Emoji换成Symbola或旧版EmojiOne：PhpStorm 2022.3+ 只认系统原生 color font，否则 emoji 显示为空白或黑白轮廓 - 如果用了
Enable font ligature，但中文注释开始乱跳，优先关掉它再测试——连字开关有时会干扰 fallback 流程
