linux容器中java中文乱码需从三方面解决：一、镜像构建时安装中文字体及zh_cn.utf-8 locale；二、运行时设置lang/lc_all环境变量；三、代码中i/o和图形操作显式指定utf-8编码及中文字体。
Linux 容器中 Java 进程中文乱码，核心问题不是 Java 本身不支持中文，而是环境缺字库、语言变量未生效、I/O 编码未显式指定这三类原因叠加导致的。解决需从容器镜像构建阶段就介入，不能只靠运行时调整。
确认并安装中文字体和语言包
Java 图形操作（如生成带中文的图片）、AWT/Swing 渲染、甚至部分日志输出依赖系统字体和 locale 支持。Alpine 或精简版 CentOS/Debian 镜像默认不含中文字体和 zh_CN locale。
- Debian/Ubuntu 镜像：在 Dockerfile 中添加
RUN apt update && apt install -y fonts-wqy-zenhei locales && locale-gen zh_CN.UTF-8 - CentOS/RHEL 镜像：
RUN yum install -y glibc-common kde-l10n-Chinese && localedef -c -i zh_CN -f UTF-8 zh_CN.UTF-8 - Alpine 镜像（推荐）：
RUN apk add --no-cache ttf-dejavu ttf-droid ttf-liberation font-noto-cjk && mkdir -p /usr/share/fonts/truetype && cp -r /usr/share/fonts/noto/* /usr/share/fonts/truetype/
设置容器运行时语言环境变量
仅安装 locale 不够，必须让 Java 进程启动时能读取到正确的 LC_ALL 或 LANG。推荐在容器启动命令或 ENTRYPOINT 前注入，避免硬编码进基础镜像。
Java Development Manual
下载
Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。 涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...
- 在 Dockerfile 的 CMD 或 ENTRYPOINT 前加环境变量：
ENV LANG=zh_CN.UTF-8 LC_ALL=zh_CN.UTF-8 - 若用 docker run 启动，显式传入：
docker run -e LANG=zh_CN.UTF-8 -e LC_ALL=zh_CN.UTF-8 ... - 验证是否生效：进入容器执行 locale，应看到 LANG=zh_CN.UTF-8 且所有字段非 "POSIX"
代码中显式指定字符编码，不依赖平台默认
即使环境配置正确，Java 的 FileReader、FileWriter、ZipInputStream 等仍会使用系统默认编码（由 locale 决定），一旦不一致就出乱码。务必在 I/O 操作中强制指定 UTF-8。
- 文件读写：
new InputStreamReader(new FileInputStream("a.txt"), StandardCharsets.UTF_8)
new OutputStreamWriter(new FileOutputStream("b.txt"), StandardCharsets.UTF_8) - 解压 ZIP 文件（尤其 Windows 打包的）：
使用 Apache Commons Compress 替代原生 java.util.zip，它支持指定 entry 名称编码：
ZipArchiveEntry entry = zipFile.getEntry(name);
String decodedName = new String(entry.getName().getBytes(StandardCharsets.ISO_8859_1), StandardCharsets.UTF_8);
或更稳妥地用 zip4j 并设置setCharset(StandardCharsets.UTF_8) - 控制台日志：Logback 或 Log4j2 配置中显式设
charset="UTF-8"，避免终端解析错误
图形渲染类乱码（如 BufferedImage.drawString）
这是最隐蔽的一类——即使文件内容、日志都正常，用 Graphics2D 绘制中文仍显示方块或空白。根本原因是 Linux 下 Java 使用 X11FontManager，找不到可用的中文字体物理文件。
- 确保已安装中文字体（见第一点），并验证路径存在：
fc-list :lang=zh 应列出 wqy-zenhei、Droid Sans Fallback 等 - Java 启动参数强制指定字体路径（可选但推荐）：
-Djava.awt.fonts=/usr/share/fonts/truetype/wqy/ - 代码中优先使用逻辑字体名，并 fallback：
Font font = new Font("WenQuanYi Zen Hei", Font.PLAIN, 12);
// 或尝试多个候选名
String[] candidates = {"Noto Sans CJK SC", "Droid Sans Fallback", "SimSun", "sans-serif"};
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
