debian golang日志乱码怎么解

在 Debian 上用 Go 程序出现日志乱码，通常不是 Go 本身的问题，而是终端编码 / 区域设置（locale）/ 输出内容编码不一致导致的。下面按常见原因逐步排查和解决。

一、先确认是不是“真的乱码”

在终端执行：

echo "中文测试"

• 如果这里也乱码 → 是 系统/终端编码问题
• 如果这里正常，只有 Go 日志乱码 → 是 Go 程序输出编码问题

二、Debian 系统 locale 设置（最常见原因）

1. 查看当前 locale

locale

如果看到：

LANG=
LC_ALL=

或者

LC_CTYPE="POSIX"

中文一定会乱码。

2. 生成 UTF-8 locale

sudo apt update
sudo apt install locales
sudo dpkg-reconfigure locales

勾选：

en_US.UTF-8
zh_CN.UTF-8

然后选默认 locale 为 en_US.UTF-8（推荐）。

3. 立即生效

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

写入环境变量（推荐）：

echo 'export LANG=en_US.UTF-8' >> ~/.bashrc
echo 'export LC_ALL=en_US.UTF-8' >> ~/.bashrc

三、终端（SSH / 本地）编码问题

SSH 客户端

• Xshell / SecureCRT / Terminal：必须设置为 UTF-8
• macOS Terminal：默认 UTF-8，一般没问题
• Windows：不要使用 GBK

测试：

printf '中文\n'

四、Go 程序本身的问题

1. Go 源码文件必须是 UTF-8

确保你的 .go 文件是 UTF-8 无 BOM：

file main.go

应显示：

main.go: UTF-8 Unicode text

如果是：

ISO-8859 / GBK

用编辑器转成 UTF-8。

2. Go 日志输出示例（正确写法）

package main

import (
    "log"
)

func main() {
    log.SetFlags(log.LstdFlags)
    log.Println("中文日志测试")
}

只要系统是 UTF-8，这里不会乱码。

五、日志写入文件后乱码？

情况 1：文件用 GBK 打开

cat app.log

如果终端是 UTF-8 但文件是 GBK，就会乱。

解决：

• 用 UTF-8 打开（VS Code / tail）
• 或转换：

iconv -f GBK -t UTF-8 app.log > app_utf8.log

六、Docker 场景（非常常见）

如果是 Docker 容器：

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

或者：

ENV LANG=en_US.UTF-8

七、快速自检清单 ✅

如果你愿意，可以把：

• 乱码截图或示例
• locale 输出
• Go 日志代码片段

发出来，我可以直接帮你定位是哪一层出的问题。