当前位置:首页 > 文章列表 > Golang > Go教程 > Go 中文字符串怎么按字符截取而不产生乱码

Go 中文字符串怎么按字符截取而不产生乱码

来源:17golang原创 2026-09-06 00:05:43 0浏览 收藏

在 Go 里,中文字符串截取乱码,通常不是编码“突然变了”,而是把字符当成了字节。string[i:j] 的下标按 UTF-8 字节偏移计算,中文一个字符往往占 3 个字节,边界落在中间就会留下不完整编码。需要按字符截取时,先转成 []rune;如果只想遍历或计数,则使用 rangeutf8.RuneCountInString

要点速览
  • len(s) 得到字节数,[]rune(s) 的长度才是 Unicode code point 数。
  • 展示标题、摘要时可用 string([]rune(s)[:n]),并先处理负数和超长 n。
  • “一个 rune”不一定等于一个用户感知字符;表情符号和组合字符要另做 grapheme cluster 分段。

为什么按字节截取会把中文切坏

Go 的字符串是只读字节序列,源码和网络文本通常以 UTF-8 表示。ASCII 字符占 1 个字节,而常见中文通常占 3 个字节,所以这段代码按下标取前 4 个字节时,可能正好截断第二个中文字符:

package main

import "fmt"

func main() {
	text := "Go语言"
	// 下标表示字节偏移,不表示第几个中文字符。
	broken := text[:4]
	fmt.Printf("%q\\n", broken)
}

这里的 4 不是“取 4 个字符”,而是“取前 4 个 UTF-8 字节”。判断长度时要把两个概念分开:

写法单位适合场景
len(text)字节协议长度、缓冲区容量
utf8.RuneCountInString(text)rune 数统计 Unicode code point
len([]rune(text))rune 数需要按字符索引或切片
Go string、UTF-8 字节、rune 与中文字符边界的静态关系图
图1:观察 string 的字节边界与 rune 边界,理解为什么中文不能直接按字节下标截取。

用 []rune 按字符截取

最直接的写法是把字符串转换为 rune 切片,再按切片下标截取。转换会把 UTF-8 字节解码成 Unicode code point,因此切片边界不会落在一个完整 rune 的中间。

package main

import "fmt"

// TakeRunes 返回前 n 个 rune;n 小于 0 时按空字符串处理。
func TakeRunes(text string, n int) string {
	if n  len(runes) {
		n = len(runes)
	}
	return string(runes[:n])
}

func main() {
	// 截取单位是 rune,不会切断“语言”中的某个 UTF-8 编码。
	fmt.Println(TakeRunes("Go语言", 4))
}

边界处理有两个重点:n 直接返回空串,避免负数切片触发 panic;n > len(runes) 收敛到实际长度,避免越界。代价是需要一份 rune 切片,长文本或高频调用时会产生额外内存和解码成本。

如果只是从头读取前 n 个 rune,不需要随机访问,可以用 range 在一次遍历中记录字节边界:

// PrefixRunes 在原字符串上找到第 n 个 rune 的字节结束位置。
func PrefixRunes(text string, n int) string {
	if n 
Go []rune 转换、range 遍历与安全字符串前缀截取的静态结构图
图2:对比 []rune 的字符索引与 range 找到的字节边界,选择适合展示文本的截取方式。

混合文本与非法 UTF-8 该怎么处理

range 遍历字符串时,每次给出一个字节位置和解码后的 rune;对非法或不完整的 UTF-8 编码,解码结果会使用 utf8.RuneError,并按一个字节向前推进。utf8.RuneCountInString 也会把错误或短编码按一个 rune 计数。

如果数据来自文件、HTTP 请求或消息队列,先决定是否接受替换字符。需要拒绝脏数据时,可以显式检查:

import "unicode/utf8"

// ValidText 只接受完整的 UTF-8 字符串。
func ValidText(text string) bool {
	return utf8.ValidString(text)
}

这一步只能说明编码序列是否合法,不能判断文本是否适合界面显示。比如一个 emoji 可能由多个 code point 组成,带组合音标的字母也可能由多个 code point 组成。若需求是“用户看到的一个字符”,要使用支持 Unicode grapheme cluster 的分段方案,而不是简单把 rune 数当作视觉字符数。

按字符和按字节的选型检查

不要为了“避免乱码”把所有字符串都转成 []rune。展示文本、标题和摘要通常按 rune 截取;协议字段、文件切片和容量限制通常按字节,但必须在协议允许的位置截断,并不能随意从 UTF-8 中间切开。

需求推荐做法注意点
按字符取前缀[]runerange处理 n 的边界
统计 Unicode code pointutf8.RuneCountInString非法 UTF-8 会按错误 rune 计数
检查输入编码utf8.ValidString决定拒绝还是替换错误数据
限制网络字段字节数按字节,但只在合法 UTF-8 边界截断不要把字节限制误当字符限制

常见问题

Go 中 rune 和字符是同一个概念吗?

rune 是 Go 对 Unicode code point 的别名;它比字节更接近“字符”,但不一定等于用户眼中的一个完整可见字符。

为什么 len("中") 不是 1?

len 返回 UTF-8 字节数,中文通常占 3 个字节;需要 rune 数时使用 utf8.RuneCountInString

只截取英文时还需要转 rune 吗?

如果输入已经明确限定为 ASCII,按字节截取和按字符截取结果一致;一旦输入可能包含中文、emoji 或其他 Unicode 文本,就应明确使用 rune 语义。

相关 API 可在 Go 官方的 unicode/utf8 文档中继续查阅,重点关注 RuneCountInStringValidString 和解码函数的返回语义。

版本声明
本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
Redis 怎么查询附近门店并按距离排序Redis 怎么查询附近门店并按距离排序
上一篇
Redis 怎么查询附近门店并按距离排序
动漫岛APP支持哪些功能?Android 5.0、离线下载与弹幕提醒说明
下一篇
动漫岛APP支持哪些功能?Android 5.0、离线下载与弹幕提醒说明
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • SuperCLUE中文大模型评测基准:功能、能力维度与应用指南
    SuperCLUE
    SuperCLUE是权威的中文大语言模型综合评测基准,涵盖语言理解、知识应用、AI Agent智能体及安全性等12项核心能力。通过多轮对话与客观测试,定期发布榜单与技术报告,为模型研发、优化及行业选型提供科学依据。
    155次使用
  • C-Eval中文评测基准:大语言模型多学科能力评估指南
    C-Eval
    深入了解C-Eval中文评估套件,涵盖52个学科与4级难度。本文详解其功能特点、Zero-shot/Few-shot使用方法及代码示例,助您全面评测LLM中文理解与泛化能力。
    85次使用
  • ClickPrompt:AI提示词生成与优化工具,支持Stable Diffusion、ChatGPT及代码辅助
    ClickPrompt
    ClickPrompt是一款专为AI提示词编写者设计的开源在线工具,支持Stable Diffusion绘图、ChatGPT对话及GitHub Copilot代码辅助。提供Prompt自动生成、一键运行、社区分享及可视化优化功能,帮助用户高效获取精准AI输出。
    45次使用
  • PromptHero官网:AI提示词搜索、优化与学习平台,支持Midjourney/Stable Diffusion
    PromptHero
    PromptHero是专业的AI提示词搜索引擎与优化平台,支持Stable Diffusion、Midjourney等主流模型。提供海量提示词库、分类搜索、在线课程及社区互动,助力用户高效生成高质量AI图像与文本。
    25次使用
  • OpenArt免费开源指南:Stable Diffusion Prompt Book提示词手册详解
    Stable Diffusion Prompt Book
    深入解析OpenArt推出的Stable Diffusion Prompt Book,这本免费的开源提示词指南涵盖从基础语法到高级技巧,提供风格化词库与参数建议,助您优化AI绘画生成效果。
    28次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议隐私政策
返回登录
  • 重置密码