PHPStorm在Debian上如何安装字体 - 问答

在 Debian 上为 PhpStorm 安装与配置字体的实用步骤

一系统级安装常用字体

更新索引并安装基础工具与常用中文字体：
- 安装字体配置与缓存工具：sudo apt-get install -y fontconfig
- 安装常见中文字库：sudo apt-get install -y ttf-wqy-zenhei
- 如需英文字体与符号更完整，可安装：sudo apt-get install -y ttf-mscorefonts-installer
将自定义字体放入系统目录并重建缓存（示例把字体放到用户目录的 fonts 文件夹）：
- 复制字体：mkdir -p ~/.local/share/fonts && cp ~/Downloads/*.ttf ~/.local/share/fonts
- 生成/更新索引：fc-cache -fv
- 验证安装结果：fc-list | grep -i “wqy|yahei|msyh”
以上完成后，系统层面已具备中文与常用编程字体的显示能力，PhpStorm 可直接使用这些字体。

二在 PhpStorm 内选择与启用字体

打开设置：File → Settings → Editor → Font（macOS 为 Preferences）
在 Primary font 选择支持中文的字体，例如：WenQuanYi Zen Hei、Noto Sans CJK SC、Microsoft YaHei（若已安装）、或编程常用等宽字体如 JetBrains Mono、Fira Code、Source Code Pro
若希望连字显示，勾选 Enable font ligature
需要更大可读性时，将字号调整到 14–16 px 区间，行距 1.3–1.5 倍更舒适
应用设置并重启 PhpStorm 以观察效果。

三解决 Java Swing 界面中文方块或乱码（JRE 字体配置法）

适用现象：PhpStorm 的提示、Git 提交信息等 UI 元素出现中文方块，但编辑器代码区正常。
原理要点：Java 运行时会读取 JRE/lib/fontconfig.properties 来决定逻辑字体与物理字体映射；若该文件或映射不匹配系统字体，就会出现方块。
操作步骤（请先备份原文件）：
1. 查找 JetBrains 自带的 JRE 目录（常见在 PhpStorm 安装下的 jbr/ 或 jre64/）
2. 进入该 JRE 的 lib/ 目录
3. 备份并重建配置：
  - mv fontconfig.properties.bfc fontconfig.properties.bfc.bak
  - cp fontconfig.properties.src fontconfig.properties
4. 编辑 fontconfig.properties，确保包含中文字体与映射，例如使用开源的 AR PL UMing（若系统已安装该字体包）：
  - 在文件中加入或确保存在：
    - filename.-misc-zysong18030-medium-r-normal–-%d---c--iso10646-1=/usr/share/fonts/truetype/arphic/uming.ttc
    - awtfontpath.chinese-cn-iso10646=/usr/share/fonts/truetype/arphic
  - 如系统未安装该字体，可安装：sudo apt-get install -y ttf-arphic-uming，或改为指向已存在的中文字体文件路径
5. 保存后重启 PhpStorm
说明：也可通过 JRE 的 fallback 目录做兜底，但更推荐直接修正映射，避免字体不统一与渲染效率问题。

四常见问题快速排查

0 赞

0 踩