Debian Golang日志乱码为何

在 Debian 上运行 Golang 程序出现日志乱码，通常不是 Go 本身的问题，而是字符编码 / 终端 / 环境不一致导致的。下面按最常见原因逐一说明。

一、最常见原因：系统/终端不是 UTF-8

现象

• 日志里中文变成 ??? 或 中文
• 在本地 macOS / Windows 正常，放到 Debian 就乱码

检查 Debian 编码

locale

正常应是：

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

如果是：

C
POSIX

那就是 非 UTF-8 环境，Go 输出 UTF-8 但终端按非 UTF-8 解析 → 乱码。

解决方法

sudo apt install locales
sudo dpkg-reconfigure locales

勾选：

en_US.UTF-8

然后：

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

二、Go 程序写日志时编码本身不对

情况 1：日志来自外部（文件 / 数据库 / 网络）

如果日志源不是 UTF-8（如 GBK），直接打印就会乱码。

示例：GBK → UTF-8

import "golang.org/x/text/encoding/simplifiedchinese"

decoder := simplifiedchinese.GBK.NewDecoder()
utf8Str, _ := decoder.String(gbkStr)
log.Println(utf8Str)

三、日志被重定向到文件后查看乱码

错误方式

./app > log.txt
cat log.txt   # 终端是 UTF-8，但文件是 GBK

解决

• 确保 Go 程序输出 UTF-8（Go 默认就是）
• 用支持 UTF-8 的编辑器查看
• 或转换文件编码：

iconv -f GBK -t UTF-8 log.txt > new.txt

四、Docker / systemd 环境常见坑

Docker

Docker 默认 C locale：

ENV LANG=C.UTF-8
ENV LC_ALL=C.UTF-8

systemd

[Service]
Environment=LANG=en_US.UTF-8

五、终端工具问题（不是 Debian 的问题）

• PuTTY：需设置 UTF-8
• SecureCRT：Session → Appearance → UTF-8
• VS Code Terminal：默认 UTF-8（一般没问题）

六、快速自检清单 ✅

locale
echo "中文测试"
file log.txt

如果：

• locale 不是 UTF-8 → 环境乱码
• file log.txt 显示 ISO-8859 / GBK → 数据源乱码
• 本地正常、服务器乱码 → 几乎都是 locale 问题

总结一句话

Debian 上 Golang 日志乱码，90% 是因为系统 locale 不是 UTF-8。

如果你愿意，可以把：

• locale 输出
• 日志片段
• 是否 Docker / systemd

发我，我可以直接帮你定位。