Golang range遍历时有哪些坑_range使用注意事项

for i, v := range slice 中 v 是副本，修改 v 不影响原切片；须用 users[i].Age = 30 或 &users[i] 修改；取 &v 地址会全部指向最后一次迭代值；map 遍历无序，增删键值行为未定义；字符串 range 返回字节索引，多字节字符需转 []rune 处理。

修改 v 不会改变原切片元素

这是最常踩的坑：用 for i, v := range slice 时，v 是元素的副本，不是引用。直接改 v 对原数据毫无影响。

• 错误写法：

  for _, v := range users {
      if v.Name == "Alice" {
          v.Age = 30 // ✗ 无效：只改了副本
      }
  }

• 正确做法：必须通过索引赋值

  for i, v := range users {
      if v.Name == "Alice" {
          users[i].Age = 30 // ✓ 改的是原切片第 i 个元素
      }
  }

• 结构体较大时，为避免拷贝开销，推荐用索引取地址：

  for i := range users {
      u := &users[i]
      u.Age = 30 // ✓ 安全且高效
  }

保存 &v 会导致所有指针指向同一地址

因为 v 在每次迭代中是复用的变量（同一内存地址），取它的地址存进 map 或切片，最后所有指针都指向最后一次迭代的值。

• 典型错误现象：

  s := []int{1, 2, 3}
  m := make(map[int]*int)
  for k, v := range s {
      m[k] = &v // ✗ 全部指向同一个 &v
  }
  // 最终 m 中所有 *int 都是 3

• 修复方式：声明局部变量复制值，再取其地址

  for k, v := range s {
      temp := v // ✅ 创建新变量
      m[k] = &temp
  }

• 更简洁写法（Go 1.22+）：for k, v := range s { m[k] = &s[k] } —— 直接取原切片元素地址

遍历 map 顺序不保证，不能依赖固定顺序

range 遍历 map 时起始哈希桶是随机的，每次运行输出顺序都可能不同。这不是 bug，而是 Go 运行时的主动设计，防止开发者误依赖顺序。

ModelGate

一站式AI模型管理与调用工具

下载

• 若需按 key 字典序遍历，必须显式排序：

  keys := make([]string, 0, len(myMap))
  for k := range myMap {
      keys = append(keys, k)
  }
  sort.Strings(keys)
  for _, k := range keys {
      fmt.Println(k, myMap[k])
  }

• 不要在遍历时增删 map 键值对 —— 行为未定义，可能导致 panic 或漏遍历
• 并发写 map（如多个 goroutine 同时 myMap[k] = v）会直接 panic，必须加锁或改用 sync.Map

字符串遍历返回字节索引，不是字符位置

range 遍历字符串时，第一个返回值是当前 rune 在字符串中的**字节起始位置**，不是第几个字符。中文、emoji 等多字节字符会让索引“跳变”。

立即学习“go语言免费学习笔记（深入）”；

• 示例："世" 占 3 字节，若它在字符串第 6 字节开始，下一个字符索引就是 9，不是 7
• 需要字符级索引（比如想取第 3 个字符）？先转 []rune：

  s := "Hello 世界"
  runes := []rune(s)
  fmt.Printf("%c", runes[6]) // ✅ 安全取第 7 个字符（"界"）

• 若只读字符内容，range 是最安全的选择；若要修改、插入、按位置访问，[]rune 更直观可靠