在Java里如何配置项目默认编码为UTF-8_Java字符集环境设置解析

落萱同学_9394

落萱同学_9394

2026-01-20

437人浏览

原创

Java项目需统一UTF-8编码:IDEA中三处设置、Maven编译encoding、JVM参数-Dfile.encoding、Spring Boot的server.servlet.encoding及Logback charset均须显式配置,否则String、文件I/O、控制台、HTTP、日志等均可能乱码。

在java里如何配置项目默认编码为utf-8_java字符集环境设置解析

Java项目默认编码不是UTF-8,除非显式配置;JVM启动参数、IDE设置、构建工具配置三者不一致时,String读写、文件I/O、控制台输出都可能乱码。

IDEA中必须改的三个地方

IntelliJ IDEA不会自动同步项目编码设置,光改File Encoding面板不够:

  • 菜单 File → Settings → Editor → File Encodings:把 Global Encoding、Project Encoding、Default encoding for properties files 全部设为 UTF-8
  • 右下角状态栏点击当前编码(如GBK),选 Convert to UTF-8 并勾选 Transparent native-to-ascii conversion(否则中文注释会变成\u4f60\u597d)
  • 检查 .idea/workspace.xml 中是否含 encoding="UTF-8",若没有,手动在 下添加

Maven编译时指定源码编码

javac 默认用系统编码编译,Windows上常是GBK,导致String字面量编译出错:

<plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-compiler-plugin</artifactid><version>3.11.0</version><configuration><source>17</source><target>17</target><encoding>UTF-8</encoding></configuration></plugin>

注意:只影响src/main/java,资源文件(如src/main/resources)需额外配置maven-resources-plugin的encoding参数。

JVM启动参数强制统一字符集

即使代码和编译都用了UTF-8,运行时仍可能因系统默认编码出问题,尤其涉及new Scanner(System.in)或Files.readAllLines():

浏览器会话(免费版)
浏览器会话(免费版)

浏览器会话管理免费版,支持一次性页面抓取、基础会话列表与简易调试。

下载
  • IDEA运行配置里,在 VM options 加:-Dfile.encoding=UTF-8
  • Maven命令行运行时加:mvn spring-boot:run -Dspring-boot.run.jvmArguments="-Dfile.encoding=UTF-8"
  • Linux部署脚本中,启动JAR前设置:export JAVA_TOOL_OPTIONS="-Dfile.encoding=UTF-8"(比-D更优先,且对所有JVM子进程生效)

⚠️ 不要用-Dsun.jnu.encoding——它只影响文件名编码,现代Java已废弃,且与file.encoding冲突时会导致不可预测行为。

Spring Boot项目的特殊处理点

Spring Boot内嵌Tomcat和WebMvcConfigurer会分别影响HTTP请求/响应编码,仅设JVM参数不够:

  • 在application.properties中必须显式配置:server.servlet.encoding.charset=UTF-8 和 server.servlet.encoding.force=true
  • 若用@RequestBody接收JSON中文,还需确认HttpMessageConverter使用StringHttpMessageConverter并设其defaultCharset为UTF_8(Spring Boot 2.3+默认已做)
  • 静态资源(HTML/CSS/JS)的必须存在,否则浏览器可能按系统编码解析,与服务端返回的Content-Type: text/html;charset=UTF-8不一致

最易忽略的是日志框架——Logback默认用系统编码写日志文件,需在logback-spring.xml中为指定UTF-8。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
如何配置Tomcat环境变量
如何配置Tomcat环境变量

配置Tomcat环境变量需要在系统中添加CATALINA_HOME变量,并将Tomcat的安装路径添加到PATH变量中。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.26

985

5

idea如何集成Tomcat
idea如何集成Tomcat

idea集成Tomcat的步骤:1、添加Tomcat服务器配置;2、配置项目部署;3、运行Tomcat服务器;4、访问项目;5、注意事项;6、关闭Tomcat服务器。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

324

5

怎么查看Tomcat源代码
怎么查看Tomcat源代码

查看Tomcat源代码的步骤:1、下载Tomcat源代码;2、在IDEA中导入Tomcat源代码;3、查看源代码;4、理解Tomcat的工作原理;5、参与社区和贡献;6、注意事项;7、持续学习和更新;8、使用工具和插件。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

509

5

常见的tomcat漏洞有哪些
常见的tomcat漏洞有哪些

常见的tomcat漏洞有:1、跨站脚本攻击;2、跨站请求伪造;3、目录遍历漏洞;4、缓冲区溢出漏洞;5、配置漏洞;6、第三方组件漏洞。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

305

5

tomcat日志乱码怎么解决
tomcat日志乱码怎么解决

tomcat日志乱码的解决办法:1、修改tomcat的日志编码设置;2、检查ide的编码设置;3、检查操作系统的编码设置;4、使用过滤器处理日志;5、检查外部系统的编码设置;6、检查文件编码方式等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

348

5

weblogic和tomcat有哪些区别
weblogic和tomcat有哪些区别

weblogic和tomcat的区别:1、功能;2、性能;3、规模;4、价格;5、安全性;6、配置和管理;7、社区支持;8、集成能力;9、升级和更新;10、可靠性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

349

5

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

601

5

tomcat启动闪退怎么解决
tomcat启动闪退怎么解决

tomcat启动闪退的解决办法:1、检查java环境;2、检查环境变量配置;3、检查端口被占用;4、检查配置文件编码;5、检查启动时需要的配置文件;6、检查相关文件是否丢失;7、检查防火墙和杀毒软件设置。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

322

5

有哪些常见的tomcat漏洞
有哪些常见的tomcat漏洞

常见的tomcat漏洞有:1、跨站脚本攻击;2、跨站请求伪造;3、目录遍历漏洞;4、缓冲区溢出漏洞;5、配置漏洞;6、第三方组件漏洞。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

3313

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程