Java项目在Eclipse中需三处统一设为UTF-8：项目级Text file encoding（右键项目→Properties→Resource）、工作空间全局编码（Window→Preferences→Workspace）、Maven的project.build.sourceEncoding；否则中文注释、文件读写、编译均可能乱码。

Java项目在Eclipse里默认编码不是UTF-8，中文注释或文件读写常乱码——必须手动改，且要改三处，缺一不可。

项目级别的Text file encoding设置

这是最常被忽略的一处。Eclipse默认用系统编码（Windows是GBK），导致.java文件保存时就把中文转成乱码字节。

• 右键项目 → Properties → Resource → 找到 Text file encoding
• 选中 Other → 输入 UTF-8（不要选Default (inherited from container)）
• 勾选 Override encoding from Workspace，否则会被工作空间设置覆盖
• 点 Apply and Close，然后右键项目 → Refresh，再打开.java文件确认中文是否正常显示

工作空间（Workspace）全局编码配置

新创建的项目会继承工作空间编码，不设好，下一个项目还得重配。

git-version-control

基于 Git 的 OpenClaw 系统配置变更版本控制。提供两项核心能力：（1）SAVE —— 在执行敏感操作前创建检查点……

下载

• 菜单栏 → Window → Preferences → General → Workspace
• 修改 Text file encoding 为 UTF-8
• 注意：改完不会自动刷新已有项目，只影响新建项目和未显式覆盖编码的旧项目
• 如果团队共用同一工作空间（比如IDE共享配置），这里必须统一，否则协作时.gitattributes都救不了

编译器源码字符集（Source Encoding）与Maven兼容性

即使文件存成UTF-8，javac若没被告知源码编码，仍可能按平台默认解码，报unmappable character错误。

立即学习“Java免费学习笔记（深入）”；

• Eclipse内置编译器默认读取Text file encoding，所以前两步做完通常够用
• 但若项目用Maven构建（pom.xml中含maven-compiler-plugin），必须额外指定：

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>

• 否则命令行执行mvn compile时会失败，而Eclipse里却正常——这种差异极易引发“本地能跑，CI挂了”的问题

真正麻烦的是混合场景：项目从SVN检出（历史编码是GBK）、又含第三方jar包内嵌非UTF-8资源、还调用new String(byte[], charset)硬编码了ISO-8859-1……这时候光调Eclipse设置没用，得逐层检查字节流源头。编码问题从来不是单点配置能根治的，而是整个I/O链路的契约一致性问题。