IDEA中Project Encoding与File Encoding必须统一设为UTF-8，否则新建文件仍为GBK、老文件读取乱码；需同步配置Global/Project/Properties编码、启用Transparent转换，并规范Maven、Git及Eclipse相关设置。

IDEA里project encoding和file encoding必须一致

很多人改了File Encoding却没同步改Project Encoding，结果新建文件还是GBK，老文件读取又乱码。IntelliJ默认用系统编码（Windows常为GBK），但Java源码必须是UTF-8——否则String.getBytes()行为不一致，Maven编译可能报unmappable character错误。

实操建议：

• 打开 Settings → Editor → File Encodings，把Global Encoding、Project Encoding、Default encoding for properties files 全设为 UTF-8
• 勾选 Transparent native-to-ascii conversion（尤其对messages_zh_CN.properties这类含中文的资源文件必需）
• 已有乱码文件别直接“Reload as UTF-8”，先用记事本另存为UTF-8无BOM，再在IDEA里File → Reload project from disk

Eclipse用户要关掉“Save resources when switching editors”

Eclipse默认在切编辑器时自动保存，而它的编码检测逻辑有坑：如果文件磁盘内容是UTF-8但未声明编码（比如没charset=UTF-8在@WebServlet或HTTP头里），它可能按平台默认编码重写一次，悄悄引入BOM或乱码。

实操建议：

• 关闭 Preferences → General → Editors → Save automatically when editor loses focus
• 手动设置每个项目右键 → Properties → Resource → Text file encoding → Other → UTF-8
• 检查.settings/org.eclipse.core.resources.prefs里是否含encoding=UTF-8，没有就补上

Maven编译乱码？重点看compiler-plugin的encoding参数

IDE编码设对了，Maven命令行编译仍报错，大概率是maven-compiler-plugin没指定编码。它默认用file.encoding系统属性，而该属性在CI环境（如Jenkins）里常为空或ISO-8859-1。

实操建议：

• 在pom.xml中显式配置插件：

  org.apache.maven.plugins
  maven-compiler-plugin
  3.11.0
  
    17
    17
    UTF-8
  

• 同时确保MAVEN_OPTS环境变量含-Dfile.encoding=UTF-8，避免被CI脚本覆盖
• 验证方式：运行mvn help:effective-pom | grep encoding，确认输出里有UTF-8

Git提交前务必检查.gitattributes是否禁用CRLF转换

Windows换行符CR+LF混入UTF-8文件，会导致某些解析器（如Spring Boot的@PropertySource）读取失败；更隐蔽的是，Git在checkout时自动转CRLF，再commit又转回LF，看似没变，实际SHA-1已不同——团队协作时频繁提示“modified: xxx.java”，本质是行尾+编码双重干扰。

实操建议：

• 项目根目录加.gitattributes，内容只留一行：* text=auto eol=lf
• 执行git rm --cached -r . && git reset --hard重建索引（

  

  注意备份未commit更改）
• IDEA用户额外勾选Settings → Editor → Code Style → Line separator → Unix and macOS (\n)

最容易被忽略的是：即使所有设置都对，旧项目迁移时git config core.autocrlf若为true，仍会偷偷转换。统一设为false，把换行控制权完全交给.gitattributes。

# java  # git  # windows  # apache  # idea  # 编码  # app  # mac  # unix  # switch  # eclipse  # spring  # spring boot  # maven  # String  # Resource  # for  # xml  # auto  # default  # bom  # ASCII  # ide  # macos  # jenkins  # http  # 设为  # 的是  # 勾选  # 已有  # 很多人  # 右键  # 这类  # 重写  # 报错  # 另存为 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251811 】 【 AI营销90571 】

相关推荐： 深圳网站制作培训,深圳哪些招聘网站比较好？  邀请函制作网站有哪些,有没有做年会邀请函的网站啊？在线制作，模板很多的那种？  Laravel怎么进行数据库回滚_Laravel Migration数据库版本控制与回滚操作  jQuery中的100个技巧汇总  Laravel如何处理文件上传_Laravel Storage门面实现文件存储与管理  Laravel Blade组件怎么用_Laravel可复用视图组件的创建与使用  Win11关机界面怎么改_Win11自定义关机画面设置【工具】  如何快速搭建个人网站并优化SEO？  标题：Vue + Vuex 项目中正确使用 JWT 进行身份认证的实践指南  独立制作一个网站多少钱,建立网站需要花多少钱？  奇安信“盘古石”团队突破 iOS 26.1 提权  Laravel API资源类怎么用_Laravel API Resource数据转换  Win11怎么更改系统语言为中文_Windows11安装语言包并设为显示语言  Google浏览器为什么这么卡 Google浏览器提速优化设置步骤【方法】  微信小程序 canvas开发实例及注意事项  如何在阿里云虚拟主机上快速搭建个人网站？  如何在IIS中新建站点并解决端口绑定冲突？  Laravel如何实现全文搜索_Laravel Scout集成Algolia或Meilisearch教程  Laravel如何使用Passport实现OAuth2？（完整配置步骤）  Laravel如何配置任务调度？（Cron Job示例）  HTML 中如何正确使用模板变量为元素的 name 属性赋值  Laravel如何编写单元测试和功能测试？（PHPUnit示例）  Laravel表单请求验证类怎么用_Laravel Form Request分离验证逻辑教程  最好的网站制作公司,网购哪个网站口碑最好，推荐几个？谢谢？  非常酷的网站设计制作软件,酷培ai教育官方网站？  JavaScript如何操作视频_媒体API怎么控制播放  Laravel如何配置Horizon来管理队列？（安装和使用）  电商网站制作多少钱一个,电子商务公司的网站制作费用计入什么科目？  如何用腾讯建站主机快速创建免费网站？  小米17系列还有一款新机？主打6.9英寸大直屏和旗舰级影像  JS弹性运动实现方法分析  如何快速使用云服务器搭建个人网站？  JavaScript如何实现倒计时_时间函数如何精确控制  Laravel如何使用Seeder填充数据_Laravel模型工厂Factory批量生成测试数据【方法】  高防服务器租用首荐平台，企业级优惠套餐快速部署  浅谈Javascript中的Label语句  网站制作软件有哪些,制图软件有哪些？  Laravel如何发送系统通知？（Notification渠道示例）  Laravel如何与Vue.js集成_Laravel + Vue前后端分离项目搭建指南  如何在Windows环境下新建FTP站点并设置权限？  laravel怎么通过契约（Contracts）编程_laravel契约（Contracts）编程方法  极客网站有哪些,DoNews、36氪、爱范儿、虎嗅、雷锋网、极客公园这些互联网媒体网站有什么差异？  Laravel Sail是什么_基于Docker的Laravel本地开发环境Sail入门  C++用Dijkstra(迪杰斯特拉)算法求最短路径  Linux虚拟化技术教程_KVMQEMU虚拟机安装与调优  Python文件操作最佳实践_稳定性说明【指导】  mc皮肤壁纸制作器,苹果平板怎么设置自己想要的壁纸我的世界？  Laravel怎么集成Vue.js_Laravel Mix配置Vue开发环境  香港服务器选型指南：免备案配置与高效建站方案解析  Swift中switch语句区间和元组模式匹配