讲师中心 微信公众号

工具推荐

视频效率加速
SoundView
SoundView

字幕擦除翻译、配音口型同步

AniShort
AniShort

AI短剧协同制作平台

updream

一键生成高质量推广成片

Laper
Laper

剧本策划到成片协作

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

落萱同学_9394

落萱同学_9394

发布时间:2026-01-20 13:58:02

|

437人浏览过

|

来源于php中文网

原创

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",若没有,手动在 <component name="EncodingManager"></component> 下添加 <file url="PROJECT" charset="UTF-8"></file>

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>

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

立即学习“Java免费学习笔记(深入)”;

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

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

下载

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)的<meta charset="UTF-8">必须存在,否则浏览器可能按系统编码解析,与服务端返回的Content-Type: text/html;charset=UTF-8不一致

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

热门AI工具

更多
Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

相关专题

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

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

985

2023.10.26

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

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

324

2024.02.23

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

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

509

2024.02.23

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

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

305

2024.02.23

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

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

348

2024.02.23

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

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

349

2024.02.23

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

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

601

2024.02.23

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

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

322

2024.02.23

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn