创建Bitbucket PR时UTF-8字符显示乱码如何解决

这个乱码不是Bitbucket本身的bug，是多层编码配置不一致叠加上IDE的“显示优化”导致的，核心原因有三个：

• IntelliJ的properties文件透明转义误导
  只要是Java生态的.properties多语言资源文件，IntelliJ默认会开启Transparent native-to-ascii conversion（透明原生转ASCII）功能：你在IDE编辑页看到的是正常的德文、中文字符，本质是IDE实时把文件里的\uXXXX转义序列渲染成了原生字符，文件实际存在磁盘上的内容全是ASCII转义码。如果你之前在编码配置不对的环境下提交过文件，错误转码产生的�（U+FFFD Unicode替换字符）会被IDE转成\uFFFD存在文件里，Bitbucket没有这个实时转义渲染逻辑，直接读原始文件内容就会出乱码。你贴的繁体中文块下半部分全是\u5E33这类转义序列，就是这个特性的典型表现。
• Git客户端编码未配置
  绝大多数人只会改IDE的全局/项目编码，不会改Git本身的编码配置：Windows环境下Git默认会用系统本地编码（中文系统是GBK、西文系统是Windows-1252）处理文本，还会自动做换行符转换，提交时会把UTF-8的多字节字符拆碎转错，最终推到远端的文件本身就已经损坏了，自然显示乱码。你贴的德文文件里的W�hrung、�berf�llig就是字符被转坏后的典型表现。
• Bitbucket编码探测错误
  如果仓库没有显式指定默认编码为UTF-8，Bitbucket会自动探测文件编码，西语资源文件因为非ASCII字符少，很容易被误判成ISO-8859-1或者Windows-1252编码，用错误编码解码UTF-8字节就会出乱码。

按顺序操作就能彻底解决：

1. 先关掉IDE的“显示滤镜”，修正本地源文件
   打开IntelliJ设置，进入Editor > File Encodings，拉到页面最底部，取消勾选Transparent native-to-ascii conversion。这时候你再打开资源文件，看到的就是文件实际存储的内容。把所有\uFFFD替换成正确的多语言字符，把不需要保留的\uXXXX转义序列全部还原成原生字符，最后确认文件用无BOM的UTF-8编码保存。可以用系统记事本或者VS Code打开文件核对，确认不通过IntelliJ打开时内容也是正常的，没有乱码。
2. 统一Git编码配置，从提交层避免转码损坏
   打开本地终端执行以下配置命令，强制Git全链路用UTF-8处理文本：

   git config --global core.quotepath false
   git config --global gui.encoding utf-8
   git config --global i18n.commit.encoding utf-8
   git config --global i18n.logoutputencoding utf-8
   # Windows环境必须执行，关闭自动换行符转换带来的编码问题
   git config --global core.autocrlf input
   

   配置完成后，把修正后的资源文件重新加入暂存区，提交前执行git show HEAD:资源文件相对路径，确认Git存储的原始文件内容无乱码后再推送到远端。
3. 配置仓库侧编码（有Bitbucket管理员权限时操作）
   进入仓库设置页，找到文件编码配置项，将默认编码设置为UTF-8，关闭自动编码探测，避免平台侧解码错误。
4. 长期规避方案
   如果是Java 8及以下的老项目，强制要求properties文件必须用ASCII编码存储，不要依赖IDE的实时转义功能，把转码逻辑放到构建流程里，通过Maven/Gradle的native2ascii插件在打包阶段统一把UTF-8源文件转成ASCII编码的properties文件，从流程上抹平不同开发环境、不同IDE的配置差异，彻底避免编码问题。

内容的提问来源于stack exchange，提问作者Bin