JetBrains IDE 如何只对当前项目切换编码

如果只是想让当前 JetBrains 项目使用 UTF-8，不要先改 Global Encoding。正确做法是进入 Settings/Preferences → Editor → File Encodings，只在 Project Encoding 中选择 UTF-8，再用状态栏和文件内容验收。项目中已有单独文件或目录编码时，它们仍可能覆盖项目默认值。

官方地址：https://www.jetbrains.com/help/idea/settings-file-encodings.html

步骤一：打开当前项目的文件编码设置

先确认目标项目已经在 IDE 中打开。Windows/Linux 选择 File → Settings，macOS 选择 IntelliJ IDEA → Preferences，然后进入 Editor → File Encodings。这一步只定位设置页，不要在 Global Encoding 处做修改。

如果使用的是 WebStorm、PyCharm 或其他 JetBrains IDE，页面名称和层级通常保持一致。看到 Global Encoding、Project Encoding 以及下方的文件/目录映射区域，就说明进入了正确页面。

步骤二：只修改 Project Encoding

在 Project Encoding 下拉框中选择 UTF-8，保持 Global Encoding 原值不变，点击 Apply，再点击 OK。这样保存的是当前项目的默认编码，其他项目不会跟着改变。

这里的“默认”很重要：IDE 只有在无法从文件或目录得到更具体编码时，才回退到项目编码。不要把下拉框选成 UTF-8 误解为所有历史文件都会立即被转换。

步骤三：检查文件和目录级覆盖

回到 File Encodings 页面下方的路径表，检查目标源码目录有没有单独指定为 GBK、ISO-8859-1 或其他编码。若只想影响当前项目，可以在这张表里添加项目内的目录路径；不要把同一个路径误加到全局配置。

如果某个文件在状态栏旁有警告图标，先别直接选择 Convert。它可能意味着把内容真正转换成新编码；对于只是想查看文件的场景，Reload 更安全。

步骤四：用状态栏和中文内容验收结果

打开当前项目中包含中文的文件，点击窗口底部状态栏的文件编码区域，确认菜单显示 UTF-8。随后关闭并重新打开文件，检查中文是否仍然正常。若弹出操作选择，Reload 只重新按新编码读取，Convert 则可能改写磁盘内容，应根据文件实际来源决定。

最后打开另一个项目的同类文件做快速对照：如果它仍保持原来的编码设置，说明这次修改确实停留在当前项目范围内。

常见问题

只改 Project Encoding 后，某个文件为什么还是乱码？

先看文件或父目录是否有单独编码映射，再检查 BOM 和文件内声明。更具体的规则会覆盖项目默认值。

应该选 Reload 还是 Convert？

只想按新编码重新查看时优先考虑 Reload；确认文件字节本身需要改成 UTF-8 时才选择 Convert，并先备份或确认版本控制可以回退。

修改 Project Encoding 会影响其他项目吗？

正常不会。其他项目使用各自的 Project Encoding；只有修改 Global Encoding，才会改变没有更具体配置的全局回退行为。