Go 默认按字节计算字符串索引，但中文等 UTF-8 字符需按 rune（Unicode 码点）定位；本文介绍如何将 strings.Index 返回的字节偏移安全转换为 rune 索引。
go 默认按字节计算字符串索引，但中文等 utf-8 字符需按 rune（unicode 码点）定位；本文介绍如何将 `strings.index` 返回的字节偏移安全转换为 rune 索引。
在 Go 中，字符串底层是字节序列（UTF-8 编码），因此 strings.Index 等标准库函数返回的是字节索引（byte offset），而非用户直观理解的“字符位置”。例如 "您好你好" 中，每个中文字符占 3 个字节，"你好" 首次出现的字节起始位置是 6，但按人类可读的字符数（即 rune 数）计数，它实际位于第 2 个 rune（索引为 2，从 0 开始）。
要获得基于 rune 的索引，核心思路是：先用 strings.Index 获取字节位置，再用 utf8.RuneCountInString(s[:byteIndex]) 统计该位置前的 rune 总数。该方法安全可靠，因为它严格按 UTF-8 解码规则统计有效码点，不会因截断多字节字符而出错。
以下为完整示例：
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
package main
import (
"fmt"
"strings"
"unicode/utf8"
)
func runeIndex(s, substr string) int {
byteIdx := strings.Index(s, substr)
if byteIdx == -1 {
return -1 // 子串未找到
}
return utf8.RuneCountInString(s[:byteIdx])
}
func main() {
s := "您好你好"
substr := "你好"
byteIdx := strings.Index(s, substr) // → 6
runeIdx := runeIndex(s, substr) // → 2
fmt.Printf("字节索引: %d\n", byteIdx) // 输出: 6
fmt.Printf("Rune 索引: %d\n", runeIdx) // 输出: 2
// 验证：按 rune 切片获取前 2 个字符
runes := []rune(s)
fmt.Printf("前 %d 个字符: %q\n", runeIdx, string(runes[:runeIdx])) // → "您好"
}
⚠️ 注意事项：
- s[:byteIdx] 是安全的，因为 strings.Index 返回的索引一定在合法字节范围内（或 -1），且 UTF-8 编码保证了任意合法前缀都是完整 rune 序列的截断（不会落在多字节字符中间）；
- 不要直接对字符串使用 len() 或 []rune(s)[i] 转换后再搜索——这会分配新切片，对大字符串不高效；上述方法仅做一次子串扫描 + 一次 rune 计数，时间复杂度 O(n)，空间复杂度 O(1)；
- 若需频繁进行 rune 索引操作（如高并发文本处理），可预先构建 rune 位置映射表以支持 O(1) 查询，但对多数场景，utf8.RuneCountInString 已足够简洁高效。
总结：Go 中实现“rune 级索引”无需重写搜索逻辑，只需将字节索引通过 utf8.RuneCountInString 投影到 rune 坐标系——这是兼顾正确性、性能与标准库兼容性的最佳实践。
