golang乱码怎么办
时间:2026-05-03 11:58:38 157浏览 收藏
小伙伴们对Golang编程感兴趣吗?是否正在学习相关知识点?如果是,那么本文《golang乱码怎么办》,就很适合你,本篇文章讲解的知识点主要包括。在之后的文章中也会多多分享相关知识点,希望对大家的知识积累有所帮助!
golang乱码本质是编码链路未对齐,核心解决法是显式控制编码转换而非依赖隐式猜测:源文件须存为无BOM的UTF-8;终端需设为UTF-8(如chcp 65001)或程序输出适配终端编码;读写文件、HTTP响应、数据库连接等各环节均需显式声明并转换字符集,确保字节流与解码预期严格一致。

golang 乱码不是语言本身的问题,而是编码链路中某处没对齐:源文件、终端、文件读写、HTTP 响应、数据库连接……只要有一环用的是 GBK 或 GB18030,而另一环默认按 UTF-8 解,就会出乱码。解决核心就一条:**显式控制编码转换,不依赖隐式猜测**。
Go 源文件保存为 UTF-8(且无 BOM)
这是最容易被忽略的起点。Windows 上用记事本保存 Go 文件,若选“ANSI”,实际是 GBK,go build 虽能过,但字符串字面量在运行时就是损坏的字节序列。
- 用 VS Code / GoLand 等现代编辑器,右下角确认编码显示为
UTF-8,点击切换并「Save with Encoding」 - 避免用 Windows 记事本直接编辑
.go文件;如必须用,保存时务必选「UTF-8」而非「ANSI」 - 检查已有文件是否含 BOM:
xxd main.go | head -1—— 若开头是ef bb bf,需用sed -i '1s/^\xef\xbb\xbf//' main.go去掉,Go 不需要 BOM
终端输出中文乱码:先看 chcp,再看程序
Windows CMD 默认代码页是 936(即 GBK),而 Go 程序输出的是 UTF-8 字节流,终端直接按 GBK 解,必然乱码。
- 临时修复:运行前在 CMD 中执行
chcp 65001(启用 UTF-8),再go run main.go - PowerShell 用户注意:
$OutputEncoding = [System.Text.Encoding]::UTF8必须设置,否则go run输出仍被错误解码 - 不改终端?那就让程序输出
GBK:golang.org/x/text/encoding/simplifiedchinese提供GB18030编码器,用transform.Writer包裹os.Stdout即可
读文件时指定编码,别信 bufio.ReadString
bufio.NewReader(f).ReadString('\n') 读出来的是原始字节,它不会自动识别文件编码。如果文件是 GBK,你拿到的就是一串 GBK 字节,当它被当 UTF-8 字符串打印,就乱。
- 正确做法:用
golang.org/x/text/encoding+transform.NewReader - 示例:读
GBK文件 → 转UTF-8字符串:f, _ := os.Open("data.txt") defer f.Close() reader := transform.NewReader(f, simplifiedchinese.GB18030.NewDecoder()) content, _ := io.ReadAll(reader) fmt.Println(string(content)) // 此时才是有效 UTF-8 字符串 - 别用
io.ReadAll(f)后再转——大文件会内存爆炸;流式转换更安全
HTTP 响应和数据库连接要显式声明 charset
Web 服务返回中文乱码,90% 是因为响应头没设 Content-Type: text/html; charset=utf-8;MySQL 查询结果乱码,大概率是连接参数漏了 charset=utf8mb4。
- HTTP:用
w.Header().Set("Content-Type", "application/json; charset=utf-8")(JSON 接口也需声明) - MySQL DSN 示例:
user:pass@tcp(127.0.0.1:3306)/db?charset=utf8mb4&parseTime=true——charset=utf8mb4是关键,utf8在 MySQL 里只是三字节伪 UTF-8 - PostgreSQL:DSN 中加
client_encoding=utf8
golang 的字符串类型是 UTF-8 字节序列,它不做任何隐式编码适配。你看到的每个乱码,都是某次读、写、传输时,字节流和解码预期错位的结果——定位那个错位点,比套用模板更重要。终于介绍完啦!小伙伴们,这篇关于《golang乱码怎么办》的介绍应该让你收获多多了吧!欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识,快来关注吧!
-
505 收藏
-
503 收藏
-
502 收藏
-
502 收藏
-
502 收藏
-
438 收藏
-
196 收藏
-
151 收藏
-
349 收藏
-
311 收藏
-
270 收藏
-
157 收藏
-
430 收藏
-
391 收藏
-
242 收藏
-
216 收藏
-
184 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习