在 Ubuntu 系统中使用 PHPStorm 时,编码格式设置几乎是绕不开的常见问题。无论是中文乱码、文件显示异常,还是项目字符集不一致,其实都可以通过几个简单步骤解决。下面就来详细看看 Ubuntu 下如何设置 PHPStorm 的编码格式。
首先,把全局和项目默认编码统一起来
打开 PHPStorm,进入 File > Settings(或者直接使用快捷键 Ctrl+Alt+S)。然后找到 Editor > File Encodings,这里就是设置 PHPStorm 编码格式的核心位置。

在这个页面中,主要需要关注以下三个关键选项:
- Global Encoding:全局编码,建议直接选择
UTF-8,这是目前兼容性最好、使用最广泛的编码格式。 - Project Encoding:项目编码,也建议设置为
UTF-8,这样能够保证整个项目中的文件编码保持一致。 - Default encoding for properties files:属性文件默认编码,同样设置为
UTF-8,可以有效避免.properties配置文件出现乱码问题。
完成设置后,点击 Apply,再点击 OK 保存即可。
按需调整特定文件类型的编码
如果你希望某些特定文件类型(例如 .html、.css、.js)使用单独的编码方式,也可以在刚才的 File Encodings 页面中进行设置。展开 File Types 部分,选择目标文件类型(比如“HTML”),然后在右侧的 Default encoding 下拉菜单中选择需要的编码格式。大多数情况下,继续使用 UTF-8 依然是更稳妥的选择。
对付那些已经乱码的“老文件”
如果打开旧文件时已经出现乱码,可以查看编辑器右下角显示的当前编码,例如 GBK。点击该编码后,选择 Other,再手动切换为正确的编码格式,比如 UTF-8。如果文件内容立即恢复正常,再点击菜单栏中的 File > Reload File from Disk 重新加载文件,这样新的编码设置通常就会生效。
给PHP文件加个“编码声明”
为了确保 PHP 文件在浏览器中能够按照正确的字符集解析,可以在文件顶部加入一段编码声明:
如果每次都手动添加会比较麻烦,那么可以借助 PHPStorm 的模板功能来自动完成。进入 Settings > Editor > File and Code Templates > Includes > PHP File Header,将上面的代码粘贴进去并保存。这样以后新建 PHP 文件时,就会自动带上这段 UTF-8 编码声明,更省事也更规范。
系统环境变量:最后的“必杀技”
如果前面的方法都尝试过了,但 PHPStorm 乱码问题仍然存在,那么很可能是 Ubuntu 系统环境变量造成的。此时可以尝试直接修改 PHPStorm 的启动脚本:找到安装目录下的 bin 文件夹,编辑 phpstorm.sh 文件,并在开头加入下面两行:
export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8
保存之后重启 PHPStorm,强制让程序使用 UTF-8 编码,通常就能从根本上解决编码格式混乱的问题。
最后还有几点提醒
- 最稳妥的做法,就是将全局编码、项目编码以及属性文件编码全部统一设置为
UTF-8,这样可以避免绝大多数因字符集不一致导致的乱码问题。 - 如果你的 Ubuntu 系统默认语言环境本身不是 UTF-8,可以使用
locale命令先检查当前环境。必要时再通过sudo dpkg-reconfigure locales命令,选择en_US.UTF-8或zh_CN.UTF-8,从系统层面彻底解决编码问题。
