Shell 脚本中文乱码报错 LC_ALL 配置不对怎么办？

大多数情况下，在脚本开头或执行环境中将 LC_ALL 设置为 en_US.UTF-8 或 zh_CN.UTF-8 即可解决中文乱码问题，适用于大多数 Linux 服务器和容器环境。

先说结论：乱码通常是因为环境变量中缺少 UTF-8 locale 配置，临时导出变量可快速止血，永久修复需修改系统 locale 配置。

快速临时修复

如果你需要立即临时修复，可以在执行脚本前加上环境变量设置，或者在脚本第一行加入导出命令：

export LC_ALL=en_US.UTF-8
export LANG=en_US.UTF-8

如果是单次执行脚本，也可以直接在命令前缀添加：

LC_ALL=en_US.UTF-8 ./your_script.sh

Linux 系统通过 locale 环境变量来控制语言、字符集和排序规则。当脚本输出中文字符时，如果系统当前的 locale 设置是 C 或 POSIX 默认值，往往只支持 ASCII 编码，无法正确解析 UTF-8 编码的汉字，从而导致终端显示为乱码。

LC_ALL 是优先级最高的 locale 变量，它会覆盖 LANG 和其他 LC_* 变量的设置。因此，强制指定 LC_ALL 为支持 UTF-8 的值，通常能直接解决编码不一致的问题。

第一步：检查当前环境

在终端输入以下命令，查看当前的 locale 设置及系统支持的编码列表：

locale
locale -a

检查输出中 LANG 和 LC_ALL 的值。如果显示 C 或 POSIX，说明未启用 UTF-8 支持。同时确认 locale -a 列表中是否存在 en_US.UTF-8 或 zh_CN.UTF-8，若不存在需先生成。

第二步：临时修复（当前会话有效）

在终端执行：

export LC_ALL=en_US.UTF-8
export LANG=en_US.UTF-8

再次运行你的脚本，看乱码是否消失。如果脚本报错说 locale 不可用，说明系统未生成该 locale，需执行第三步。

第三步：永久修复（系统级）

对于 CentOS/RHEL 系列，编辑 /etc/locale.conf：

LANG="en_US.UTF-8"
LC_ALL="en_US.UTF-8"

对于 Ubuntu/Debian 系列，通常使用 locale-gen 生成并配置：

sudo locale-gen en_US.UTF-8
sudo update-locale LANG=en_US.UTF-8

对于 Alpine 容器环境，默认不包含 locale 支持，建议安装 musl-locales 而非复杂的 glibc：

apk add `--no-cache` musl-locales
export LC_ALL=en_US.UTF-8

修改后需要重新登录或重启系统生效。

第四步：脚本内固定（推荐）

为了保险，建议在脚本开头显式声明，避免依赖外部环境：

#!/bin/bash
export LC_ALL=en_US.UTF-8
export LANG=en_US.UTF-8

执行以下命令检查变量是否已变更：

echo $LC_ALL
echo $LANG

输出应显示 en_US.UTF-8 或 zh_CN.UTF-8。此外，可以创建一个包含中文 echo 的测试脚本，运行后观察终端显示是否为正常汉字而非问号或乱码符号。

1. 最小化容器环境：Alpine 等精简镜像需执行 apk add musl-locales 并配置环境变量，避免直接安装 glibc 增加复杂度。

2. SSH 客户端设置：即使服务器配置正确，如果本地 SSH 客户端（如 Putty、Terminal）编码设置为 GBK 或其他非 UTF-8 格式，依然会显示乱码。

3. 变量覆盖：某些程序内部会重置环境变量，如果在脚本中间调用其他程序，可能需要再次导出变量。

4. zh_CN 与 en_US：如果系统未安装中文语言包，设置 zh_CN.UTF-8 可能会报错，此时使用 en_US.UTF-8 通常也能正常显示中文，因为关键在于 UTF-8 编码而非语言本身。

GNU Bash Manual, Environment Variables section, https://www.gnu.org/software/bash/manual/
Linux Man Pages, locale(7), https://man7.org/linux/man-pages/man7/locale.7.html