Java项目必须显式统一设置UTF-8编码：编译阶段用-javac -encoding UTF-8、Maven配encoding、Gradle设compileJava.options.encoding；运行阶段加-Dfile.encoding=UTF-8；IDE需同步全局、项目及properties文件编码；IO与网络操作须显式指定StandardCharsets.UTF_8，properties文件须无BOM。

Java项目默认使用系统编码，跨平台时极易出现中文乱码，必须显式统一设置为UTF-8。

编译阶段：javac命令必须加-encoding参数

即使源文件保存为UTF-8，javac默认按系统编码读取，Windows上常为GBK，导致编译时报错或生成错误字节码。

• 正确做法：所有javac调用都显式指定-encoding UTF-8，例如：

  javac -encoding UTF-8 src/com/example/Hello.java

• Maven项目需在pom.xml中配置maven-compiler-plugin的encoding属性为UTF-8
• Gradle项目需在build.gradle中设置compileJava.options.encoding = "UTF-8"

运行阶段：JVM启动参数要加-Dfile.encoding

System.getProperty("file.encoding")返回的值决定String.getBytes()、new String(byte[])等操作的默认编码，不设则继承操作系统，Li

• 必须添加JVM参数：-Dfile.encoding=UTF-8
• IDE中（如IntelliJ IDEA）需在Run Configuration → VM options里填写，不能只改文件编码设置
• Spring Boot应用若打成jar包运行，需在java -jar命令后加上该参数：

  java -Dfile.encoding=UTF-8 -jar myapp.jar

IDE与源文件：三处UTF-8必须同步

IDE设置、文件实际编码、项目配置不一致是乱码高发区，尤其在团队协作中。

• IntelliJ IDEA：进入File → Settings → Editor → File Encodings，把Global Encoding、Project Encoding、Default encoding for properties files全部设为UTF-8
• Eclipse：在Preferences → General → Workspace → Text file encoding选Other: UTF-8，并勾选Always use encoding specified in the file
• 检查已有Java文件是否真为UTF-8：用file -i filename.java（Linux/macOS）或Notepad++的编码菜单确认，避免BOM或ANSI残留

IO与网络：显式指定编码，绝不依赖默认

任何涉及字节与字符串转换的API，只要没传编码参数，就等于埋雷。

• 读写文件：用Files.readAllLines(path, StandardCharsets.UTF_8)，而非Files.readAllLines(path)
• 字符流：用InputStreamReader(in, StandardCharsets.UTF_8)，不用无参构造
• HTTP响应：Servlet中必须调用response.setCharacterEncoding("UTF-8")，且在getWriter()前设置
• JSON库（如Jackson）：配置ObjectMapper的setDefaultCharset(StandardCharsets.UTF_8)

最易被忽略的是Maven资源过滤和Spring Boot的application.properties加载——它们默认不识别UTF-8 BOM，含中文的properties文件必须保存为无BOM UTF-8，否则Spring会把开头的EF BB BF当乱码解析。

# linux  # java  # js  # json  # windows  # idea  # 操作系统  # 编码  # app  # 字节  # mac  # 中文乱码 

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

相关推荐： java中使用zxing批量生成二维码立牌  html5源代码发行怎么设置权限_访问权限控制方法与实践【指南】  高性能网站服务器配置指南：安全稳定与高效建站核心方案  详解Android——蓝牙技术 带你实现终端间数据传输  如何自定义safari浏览器工具栏？个性化设置safari浏览器界面教程【技巧】  西安市网站制作公司,哪个相亲网站比较好?西安比较好的相亲网站？  香港服务器选型指南：免备案配置与高效建站方案解析  Laravel怎么实现微信登录_Laravel Socialite第三方登录集成  高端网站建设与定制开发一站式解决方案 中企动力  Laravel如何实现URL美化Slug功能_Laravel使用eloquent-sluggable生成别名【方法】  绝密ChatGPT指令：手把手教你生成HR无法拒绝的求职信  Laravel怎么写单元测试_PHPUnit在Laravel项目中的基础测试入门  Android实现代码画虚线边框背景效果  Laravel Eloquent访问器与修改器是什么_Laravel Accessors & Mutators数据处理技巧  长沙企业网站制作哪家好,长沙水业集团官方网站？  Laravel如何使用Eloquent进行子查询  教你用AI将一段旋律扩展成一首完整的曲子  javascript基本数据类型及类型检测常用方法小结  如何登录建站主机？访问步骤全解析  如何确保FTP站点访问权限与数据传输安全？  网站设计制作书签怎么做,怎样将网页添加到书签/主页书签/桌面？  如何快速配置高效服务器建站软件？  Windows驱动无法加载错误解决方法_驱动签名验证失败处理步骤  JavaScript常见的五种数组去重的方式  bootstrap日历插件datetimepicker使用方法  如何构建满足综合性能需求的优质建站方案？  济南网站建设制作公司,室内设计网站一般都有哪些功能？  Laravel Eloquent性能优化技巧_Laravel N+1查询问题解决  Laravel如何配置任务调度？（Cron Job示例）  长沙做网站要多少钱,长沙国安网络怎么样？  Android中Textview和图片同行显示(文字超出用省略号，图片自动靠右边)  如何自定义建站之星网站的导航菜单样式？  Java Adapter 适配器模式（类适配器，对象适配器）优缺点对比  如何生成腾讯云建站专用兑换码？  Laravel用户密码怎么加密_Laravel Hash门面使用教程  Windows10如何删除恢复分区_Win10 Diskpart命令强制删除分区  制作无缝贴图网站有哪些,3dmax无缝贴图怎么调？  Firefox Developer Edition开发者版本入口  百度输入法ai面板怎么关 百度输入法ai面板隐藏技巧  活动邀请函制作网站有哪些,活动邀请函文案？  Win11怎么恢复误删照片_Win11数据恢复工具使用【推荐】  大连网站制作公司哪家好一点,大连买房网站哪个好？  如何制作一个表白网站视频,关于勇敢表白的小标题？  如何在自有机房高效搭建专业网站？  Python企业级消息系统教程_KafkaRabbitMQ高并发应用  瓜子二手车官方网站在线入口 瓜子二手车网页版官网通道入口  家族网站制作贴纸教程视频,用豆子做粘帖画怎么制作？  如何用VPS主机快速搭建个人网站？  在线制作视频网站免费,都有哪些好的动漫网站？  Edge浏览器如何截图和滚动截图_微软Edge网页捕获功能使用教程【技巧】