在 Ubuntu 系统中使用 PHPStorm 进行开发时,编码配置是不可避免的关键环节——尤其当项目涉及中文或其他非 ASCII 字符时,稍有不慎便会遭遇乱码困扰。下面直接进入正题,系统梳理 PHPStorm Ubuntu 版本的编码设置路径与操作步骤。

1. 打开 PHPStorm 设置界面
启动 PHPStorm 后,点击顶部菜单栏的 File > Settings(或直接使用快捷键 Ctrl+Alt+S),即可调出设置对话框。该入口是后续所有编码配置的起点。
2. 导航至文件编码选项
在设置窗口左侧的导航树中,找到 Editor 并展开,然后点击 File Encodings(文件编码)。这里是 PHPStorm 集中管理编码的核心区域,所有全局级与项目级的编码相关参数均在此处完成。
3. 调整全局与项目编码参数
进入 File Encodings 页面后,你会看到三大配置模块:
- Global Encoding(全局编码):控制 PHPStorm 整体的默认编码,强烈建议选择 UTF-8——兼容性最佳,可覆盖绝大多数日常开发场景。
- Project Encoding(项目编码):针对当前打开的项目单独设置,同样推荐 UTF-8,以确保项目内所有文件编码统一,避免跨文件出现乱码。
- Default encoding for properties files(属性文件默认编码):专门用于
.properties这类配置文件,也建议设为 UTF-8,否则中文注释或特殊字符极易变成“天书”无法阅读。
4. 可选:为特定文件类型指定编码
如果某些文件类型(例如 .html、.php、.js)需要单独设置编码,可以在 File Encodings 页面下方的 File Types 区域进行配置。例如,将 .php 文件关联为 UTF-8,这样即使项目整体编码不同,也能保证 PHP 文件中的中文正常显示,不出现乱码。
5. 应用并保存配置
所有调整完成后,点击设置窗口右下角的 OK 按钮保存更改。建议重启 PHPStorm,让新编码设置彻底生效——尤其是在项目文件较多或已有缓存的情况下,重启能确保所有配置正确加载。
补充说明
如果按照上述步骤操作后仍出现乱码,可以从两个方向排查:一是检查系统环境编码,在终端执行 echo $LANG,确认输出是否为 UTF-8;二是在 PHP 文件头部添加 header('Content-Type: text/html; charset=utf-8');,强制声明编码,确保浏览器正确解析。这两个小技巧通常能解决大多数“顽固”乱码问题。
