关键在于三步协同：1.安装语言包并用locale-gen生成zh_CN.UTF-8；2.安装wqy-microhei、noto-cjk等字体并刷新缓存；3.用ENV全局设置LANG、LANGUAGE、LC_ALL为zh_CN.UTF-8。
在 Dockerfile 中解决中文乱码，关键不是只改一个环境变量，而是让容器从构建起就具备完整的中文支持能力——包括语言环境生成、中文字体安装、环境变量固化三者缺一不可。
生成 zh_CN.UTF-8 locale 数据
Ubuntu/Debian 镜像默认不启用中文 locale，仅装语言包不够，必须显式生成。否则 locale -a | grep zh_CN 会查不到结果。
- 安装 locales 和中文语言包：
RUN apt-get update && apt-get install -y locales language-pack-zh-hans - 启用中文条目（用 sed 替换注释）：
RUN sed -i 's/^# *zh_CN.UTF-8 UTF-8/zh_CN.UTF-8 UTF-8/' /etc/locale.gen - 执行生成：
RUN locale-gen
预装可靠中文字体并刷新缓存
没有字体，再正确的编码也显示为方块。wqy-microhei 是基础，但建议叠加 Noto 系列以覆盖更多字形（如 emoji、生僻字）。
- 安装字体：
RUN apt-get install -y fonts-wqy-microhei fonts-noto-cjk fonts-noto-color-emoji - 强制重建字体缓存：
RUN fc-cache -fv - 验证是否生效：
RUN fc-list :lang=zh | head -n 2应输出含 Noto Sans CJK 或 WenQuanYi Micro Hei 的路径
全局设置环境变量，避免被覆盖
LANG、LC_ALL 必须在镜像层就设好，不能依赖 shell 启动文件（如 ~/.bashrc），否则非交互式容器或后台进程会失效。
- 使用 ENV 一次性设定：
ENV LANG=zh_CN.UTF-8 LANGUAGE=zh_CN:zh LC_ALL=zh_CN.UTF-8 - 特别注意：LC_ALL 不可为空或设为 C/POSIX，它会强制覆盖所有其他 LC_* 变量
- 构建后验证：
docker run --rm your-image locale输出中所有 LC_* 均应为 zh_CN.UTF-8
构建后快速验证要点
别等上线才发现问题，构建完立刻跑几条命令确认：
-
locale—— 检查 LANG 和 LC_CTYPE 是否为 zh_CN.UTF-8 -
echo "测试中文" | cat—— 观察终端是否原样输出，而非问号或方块 - 若仍乱码，检查是否在
docker run时加了-e LANG=C这类覆盖参数
