Go range 遍历 map 的顺序为什么每次不同

Go 里用 for key, value := range m 遍历 map 时，输出顺序每次不同是正常现象。原因不是你的 fmt.Println 写错了，而是 Go 语言规范没有为 map 的迭代顺序定义稳定规则，也不保证同一个 map 的两次迭代顺序相同。

官方规范：https://go.dev/ref/spec

因此，map 适合通过键快速取值，不适合直接承担“按固定顺序展示、生成可比文本或拼接签名输入”的职责。需要确定性结果时，应先把键复制到切片，明确排序规则，再按排序后的键读取 map。

map range 实际保证了什么

对一个类型为 map[K]V 的值使用 range，两个迭代变量分别接收键 K 和对应的值 V。规范保证的是“会产生这些键值关系”，而不是“按照插入顺序、字典序或某个固定内部顺序产生”。

package main

import "fmt"

func main() {
	prices := map[string]int{
		"tea":    18,
		"coffee": 26,
		"juice":  12,
	}

	// range 能拿到每个键和值，但不能把输出顺序当成协议。
	for name, price := range prices {
		fmt.Printf("%s=%d ", name, price)
	}
	fmt.Println()
}

这段代码每次都可能以不同顺序打印三个条目。它仍然满足 map 的语义：每个已存在的键对应自己的值都能被访问。只要业务只关心集合内容，例如统计、查找或构建索引，就不应该对打印顺序做断言。

为什么不要把一次输出当成稳定顺序

“这次运行看起来是按插入顺序”并不等于 Go 承诺了插入顺序。map 的具体实现细节属于运行时内部，不是应用程序可以依赖的语言接口；程序重启、数据变化、编译环境变化或仅仅再次迭代，都可能让观察到的顺序不同。

更重要的是，规范还明确了遍历期间增删条目的边界：尚未遍历到的条目被删除后，可能不会产生对应迭代值；遍历期间创建的新条目可能被访问，也可能被跳过。这个选择对不同新条目、不同迭代都可能不同。

所以，下面两类写法都有隐患：

• 把 map 的第一次 key 当成“最早插入的记录”；
• 把 map 直接格式化后的文本用于快照测试、缓存键、签名或跨服务比较。

如果测试只想比较集合内容，可以把结果放入不依赖顺序的结构中比较；如果产品要求可读且稳定的展示，就应该在代码里显式定义排序策略。

需要稳定输出时，先排序键再读取值

map 本身没有“原地排序”这个操作。通用做法是单独收集键，排序键切片，然后使用排序后的键访问原 map。下面的示例按字符串升序输出，稳定性来自 sort.Strings，不是来自 map。

package main

import (
	"fmt"
	"sort"
)

func printByName(prices map[string]int) {
	keys := make([]string, 0, len(prices))
	for name := range prices {
		// 这里只收集键，不从 map 推断任何遍历顺序。
		keys = append(keys, name)
	}

	// 明确规定展示顺序：按商品名的字节序升序排列。
	sort.Strings(keys)
	for _, name := range keys {
		// map 负责按键取值，keys 负责提供稳定的访问顺序。
		fmt.Printf("%s=%d ", name, prices[name])
	}
	fmt.Println()
}

func main() {
	printByName(map[string]int{
		"tea":    18,
		"coffee": 26,
		"juice":  12,
	})
}

这里的输出顺序由 juice、coffee、tea 的排序规则决定。若键是整数，可以使用 sort.Ints；如果项目使用 Go 1.21 或更高版本，也可以采用 slices.Sort(keys)。选择哪个函数不改变核心原则：稳定性来自显式排序。

不同需求应该怎样处理

遍历 map 时还要留意两个边界

第一，nil map 可以被安全地 range，循环次数为零；但向 nil map 写入会触发运行时错误。第二，普通 map 不能被无保护地并发读写。即使某一轮恰好打印出了理想顺序，也不能用它证明并发访问是安全的。

package main

import "fmt"

func count(m map[string]int) int {
	total := 0
	for _, value := range m {
		// 统计只依赖值，不依赖键出现的先后。
		total += value
	}
	return total
}

func main() {
	var empty map[string]int
	fmt.Println(count(empty)) // nil map range 不产生迭代值
}

如果需要在遍历中删除条目，必须先确认业务是否接受“尚未访问的条目可能不再产生迭代值”；如果需要加入条目，也不能假设新条目一定会在本轮被访问。对这类逻辑，通常把“选择待处理键”和“修改 map”拆成两个阶段会更容易解释和测试。

结论与常见追问

Go range 遍历 map 的顺序每次不同，根本原因是语言规范没有指定 map 的迭代顺序，也没有保证连续两次迭代相同。把 map 当作无序集合使用时直接 range；把结果用于展示、测试、签名或跨服务传输时，先复制键、定义排序规则，再按键取值。

map 会按照插入顺序遍历吗？

不会。插入顺序不是 map range 的语言保证，不能作为业务逻辑依据。

只想让 JSON 输出稳定，应该怎么做？

先明确字段排序或使用能提供确定性编码的方案，不要把某次 map range 的顺序直接当作规范化结果。

遍历 map 时删除键安全吗？

语言规范定义了删除未访问条目的结果边界，但这不代表所有业务都适合边遍历边修改。若结果必须完整可预测，先收集待删除键，再统一修改更清楚。