问题概述
问题现象
在使用新版 IntelliJ IDEA 执行 Maven 构建项目时,控制台输出警告信息:
Picked up JAVA_TOOL_OPTIONS: -Dfile.encoding=GBK
问题排查过程
初步判断
初始假设:系统环境变量设置了 Java 编码为 GBK。
环境变量验证
# 检查环境变量
$env:JAVA_TOOL_OPTIONS
# 输出:%JAVA_TOOL_OPTIONS%(表示变量未显式设置)
排查结果:系统环境中并未手动设置 JAVA_TOOL_OPTIONS 变量。
IDE 配置排查
怀疑方向:IDEA 内部设置或配置文件指定了 GBK 编码。
检查项包括:
- IDEA VM Options:Help → Edit Custom VM Options
- Maven Runner 配置:Settings → Build Tools → Maven → Runner
- 项目配置:
.idea目录下的配置文件 - Maven 配置文件:
settings.xml和pom.xml
排查结果:IDEA 配置中未发现显式的 GBK 编码设置。
系统级排查
关键发现:通过检查 Windows 区域设置,定位问题根源。
检查步骤:
- 控制面板 → 时钟和区域 → 区域
- 管理标签页 → 更改系统区域设置
- 发现未勾选 "Beta 版:使用 Unicode UTF-8"
根本原因分析
核心原因
Windows 中文系统区域设置的默认行为 + IDEA 自动检测机制。
触发机制
猜测机制:新版 IDEA 可能具备以下行为:
- 自动系统扫描:启动时扫描系统区域设置
- 智能编码配置:根据区域自动设置编码
- 环境变量注入:自动配置 JAVA_TOOL_OPTIONS
问题触发流程:
IDEA 启动
↓ 扫描系统区域设置(发现中文中国)
↓ 自动配置编码为 GBK("智能" 行为)
↓ 注入 JAVA_TOOL_OPTIONS=-Dfile.encoding=GBK
↓ Maven 构建时继承此设置
↓ 控制台显示警告信息
解决方案
方案选择
修改系统区域设置。
操作步骤
步骤 1:访问区域设置
开始菜单 → 设置 → 时间和语言 → 语言和区域
或 控制面板 → 时钟和区域 → 区域
步骤 2:进入高级设置
点击 下的
在弹出的窗口中点击

