Go 遍历 Map

Map 中的数据是以键值对的形式无序存放的,并没有 0、1、2 这样的连续数字下标。因此,我们不能使用普通的三段式 for 循环来遍历,只能使用 for range 循环把里面的元素逐个取出来。

遍历 Map 的键值对

前面遍历切片时,for range 循环每一轮返回的是 “数字下标” 和 “元素值”。在 Go 语言中,遍历 Map 的语法形式完全一样,只不过每一轮返回的两个值变成了 “键(Key)” 和 “值(Value)”。

语法:

for k, v := range m {
    // 循环体
}

说明:

在上面的语法中,我们习惯使用 k(key 的首字母)接收每一项的键,使用 v(value 的首字母)接收对应的值。每执行一轮循环,k 和 v 就会自动更新为下一组键值对的数据,直到把整个 Map 遍历完为止。

示例 1:遍历 Map 的键和值

package main

import "fmt"

func main() {
    scores := map[string]int{
        "语文": 90,
        "数学": 95,
        "英语": 88,
    }

    for k, v := range scores {
        fmt.Printf("%s: %d\n", k, v)
    }
}

运行结果如下。

数学: 95
英语: 88
语文: 90

分析:

for k, v := range scores 表示依次取出 scores 中的每一组键值对。其中变量 k 拿到的是科目名称,变量 v 拿到的是对应的分数,最后通过 fmt.Printf() 打印出来。

小伙伴们运行这段代码时会发现:虽然代码里写的顺序是 “语文、数学、英语”,但打印出来的顺序却可能是 “数学、英语、语文”。这是因为 Map 底层的存储本身是无序的,每次运行遍历的先后顺序都可能不一样。

这里还有一个新手很容易踩的坑:在 for k, v := range scores 循环中,变量 v 只是从 Map 里复制出来的一份副本。直接修改 v 并不会改变原 Map 里的数据。如果想要在遍历时给每门课统一加 10 分,我们必须通过键来给原 Map 赋值。

// 正确方式
for k := range scores {
    scores[k] += 10
}

// 错误方式
for _, v := range scores {
    v += 10
}

只遍历键或只遍历值

在实际开发中,有时我们不需要同时用到键和值,而是只想获取所有的键,或者只想统计所有的值。此时我们可以简化 for range 左边的接收变量。

语法:

// 只遍历键
for k := range m {
    // 循环体
}

// 只遍历值
for _, v := range m {
    // 循环体
}

说明:

当只遍历键或只遍历值时,我们需要注意以下 2 点:

  • 只遍历键:在 := 左边只写一个变量 k 即可,直接省略第 2 个变量。
  • 只遍历值:不能直接删掉第 1 个变量,必须使用匿名变量(_)把第 1 个键的位置占住并忽略掉,这样第 2 个变量 v 拿到的才是值。

示例 2:只遍历 Map 的键

package main

import "fmt"

func main() {
    scores := map[string]int{
        "语文": 90,
        "数学": 95,
        "英语": 88,
    }

    for k := range scores {
        fmt.Println(k)
    }
}

运行结果如下。

英语
语文
数学

分析:

for k := range scores 左边只保留了一个变量 k,程序在遍历时就会忽略后面的分数,只取出每一项的科目名称并打印出来。

示例 3:只遍历 Map 的值

package main

import "fmt"

func main() {
    costs := map[string]int{
        "早餐": 12,
        "午餐": 28,
        "晚餐": 25,
    }

    total := 0
    for _, v := range costs {
        total += v
    }

    fmt.Println(total)
}

运行结果如下。

65

分析:

在这个例子中,我们只需要把三餐的花费加起来,并不关心餐次的名称。因此我们使用 for _, v := range costs 忽略掉前面的键名,只取出每一项的花费 v 累加到 total 中,最终算出总花费为 65。

这里小伙伴们要特别注意:只要 := 左边只写一个变量,不管这个变量起名叫 k 还是叫 v,它拿到的永远都是第 1 个返回值(也就是键)。对于上面这个例子,如果漏掉了前面的下划线,下面这种写法就是错误的。

for v := range costs {
    total += v    // 编译报错
}

由于此时 v 拿到的是 string 类型的餐次名称,不能直接与整数 total 相加,编译时就会直接报错。

按固定顺序遍历 Map

虽然直接遍历 Map 的顺序是不固定的,但在生成对账单或导出报表等场景中,我们通常希望每次遍历输出的顺序都固定一致。

那应该怎么实现呢?我们可以分 3 步来完成:① 先把 Map 里所有的键提取到一个切片中;② 调用标准库 slices 包提供的 slices.Sort() 函数对键切片排好序;③ 按照排好序的键切片,依次去 Map 中读取对应的值。

示例 4:按键排序后遍历 Map

package main

import (
    "fmt"
    "slices"
)

func main() {
    m := map[string]int{
        "b": 20,
        "a": 10,
        "c": 30,
    }

    // 1. 提取所有键到切片中
    var keys []string
    for k := range m {
        keys = append(keys, k)
    }

    // 2. 对键切片升序排序
    slices.Sort(keys)

    // 3. 按排好序的键依次读取值
    for _, k := range keys {
        fmt.Printf("%s: %d\n", k, m[k])
    }
}

运行结果如下。

a: 10
b: 20
c: 30

分析:

上面代码开头通过 import 小括号分组,同时引入了 "fmt" 和 "slices" 两个标准库包。在 main() 函数中,我们先通过 for k := range m 把所有的键收集到字符串切片 keys 里,再调用 slices.Sort(keys) 将键名按字母升序排成 ["a", "b", "c"]。

由于切片本身是有序的,最后我们按顺序遍历 keys 切片,通过 m[k] 依次读取对应的值,打印出来的顺序就会始终固定为 "a"、"b"、"c"。如果希望按降序输出,排序后再调用 slices.Reverse(keys) 反转一下键切片即可。

另外,如果 Map 里存放的数据量比较大,在第 1 步创建切片时我们也可以写成 keys := make([]string, 0, len(m))。提前把容量预留好,可以减少 append() 反复扩容的开销。当然了,平时如果业务上不要求固定顺序,我们直接使用 for k, v := range m 遍历即可,不需要额外排序。

常见问题

1. 为什么 Go 语言每次遍历 Map 打印出来的顺序都是随机变化的?

这是 Go 语言故意设计的一个机制。Map 底层采用哈希表存储数据,当往里面添加或删除元素触发扩容时,键的存储位置本来就会改变。在早期的 Go 版本中,有些开发者发现不扩容时遍历顺序看似固定,就写出了依赖特定顺序的代码。结果一旦数据量变大触发扩容,程序就会出现难以排查的错误。

为了消除这种隐患,Go 语言在执行 for range 遍历 Map 时,底层会随机挑选一个起始位置,借此提醒大家不要依赖 Map 的遍历顺序。另外还要注意,直接调用 fmt.Println(m) 打印整个 Map 时,标准库为了方便查看会自动按键排序显示,但这并不代表 Map 本身是有序的。

2. 在 for range 遍历 Map 的过程中,可以删除里面的元素吗?

可以。在 Go 语言中,使用 for range 遍历 Map 时,直接调用 delete() 函数删除当前键或其他指定键是完全安全的,不会引发报错。比如统计成绩时,我们可以边遍历边把不及格的记录清理掉。

不过需要注意,如果在遍历过程中往同一个 Map 里新增键值对,Go 语言并不保证新添加的数据一定会在本轮循环中被遍历到。因此,平时尽量不要在遍历 Map 的同时往里面新增元素。

给站长反馈

绿叶网正在不断完善中,小伙伴们如果发现任何问题,还望多多给站长反馈,谢谢!

邮箱:lvyenet@vip.qq.com

「绿叶网」服务号
绿叶网服务号放大
关注服务号,微信也能看教程。
绿叶网服务号