Go slices.Values 怎样把切片转换为迭代器

如果手里已经有一个切片，只想把它交给支持 Go 迭代器的代码处理，可以使用 slices.Values。它返回一个 iter.Seq，随后直接用 range 逐项读取切片元素，不需要先手写一个 yield 回调。它的核心语义是“按原顺序暴露元素”，不是复制切片，也不是把结果预先计算成另一份切片。

结论：slices.Values(s) 适合把现有切片接到迭代器接口上。需要独立快照时再用 slices.Clone，需要把迭代器重新收集成切片时才用 slices.Collect。

slices.Values 返回什么

Go 官方标准库中，slices.Values 的签名是 func Values[Slice ~[]E, E any](s Slice) iter.Seq[E]。其中 ~[]E 允许底层类型是切片的自定义类型，返回的序列会依次产生输入切片中的元素。

可以把它理解成一个轻量适配器：左侧仍然是切片，右侧是一个可被 range 消费的 iter.Seq。调用 Values 本身不会把元素重新排序，也不会把切片变成一个拥有独立存储的副本。

怎样用 slices.Values 配合 range

最常见的写法是把 Values 放在 range 后面。下面的示例只展示接口连接关系，代码中的注释说明了输入、消费方式和停止条件。

package main

import (
	"fmt"
	"slices"
)

func main() {
	names := []string{"Alice", "Bob", "Vera"}

	// Values 按切片原有顺序提供一个 iter.Seq，range 逐项消费它。
	for name := range slices.Values(names) {
		// 这里的 name 是当前元素，不需要手动维护索引。
		fmt.Println(name)
	}
}

如果调用方只需要值，不需要下标，这种写法比手动写 for i := range names 更直接；如果还要下标，则可以继续使用普通切片循环，或者根据接口需求选择 slices.All 这样的索引和值序列。

顺序、nil 和空切片怎么处理

Values 会按切片的索引顺序产生元素。因此，输入是 []int{4, 1, 9} 时，迭代顺序就是 4、1、9，不会因为它是迭代器而自动排序。

对 nil 切片和长度为零的空切片，迭代器都不会产生元素。也就是说，下面的两个循环都不会进入循环体；它们的区别通常只在于原切片本身是否为 nil，而不是可见的迭代结果。

package main

import (
	"fmt"
	"slices"
)

func main() {
	var nilNames []string
	emptyNames := []string{}

	// 两个输入都没有元素，所以循环体都不会执行。
	for range slices.Values(nilNames) {
		fmt.Println("不会打印")
	}
	for range slices.Values(emptyNames) {
		fmt.Println("也不会打印")
	}

	// 这里保留原切片的 nil 判断，避免把迭代结果误当成 nil 状态。
	fmt.Println(nilNames == nil, emptyNames == nil)
}

要注意，Values 的任务是提供元素序列，不是提供一个“可比较的空结果”。如果业务需要区分 nil 与非 nil 的空切片，应当在创建序列之前保留对原切片的判断。

自定义切片类型也能使用吗

签名中的 Slice ~[]E 表示底层是 []E 的命名切片也可以传入。这对领域模型很实用：可以保留自己的类型名，同时把它接入只接受 iter.Seq 的通用函数。

package main

import (
	"fmt"
	"slices"
)

type UserNames []string

func main() {
	names := UserNames{"Ada", "Lin"}

	// 命名切片仍然符合 ~[]E，Values 会按原顺序产生 string。
	for name := range slices.Values(names) {
		fmt.Println(name)
	}
}

这里的元素类型仍是 string，而输入保留了 UserNames 这个业务类型。这样可以在边界处使用迭代器，在业务层继续保持清晰的类型名称。

迭代期间修改切片会看到什么

Values 不是快照。它把原切片适配成序列，因此不要把它当成自动复制。若在迭代过程中通过别的逻辑修改底层切片，后续元素的可见结果会受到普通切片别名和生命周期规则影响；更稳妥的做法是避免并发修改，或在交给异步、延迟消费的代码前先复制。

如果需要明确的独立数据副本，可以先克隆：

package main

import (
	"fmt"
	"slices"
)

func main() {
	original := []string{"draft", "ready"}
	snapshot := slices.Clone(original)

	// 修改原切片后，快照仍持有自己的元素存储；这是需要独立生命周期时的选择。
	original[0] = "sent"
	for value := range slices.Values(snapshot) {
		fmt.Println(value)
	}
}

Values、Clone 和 Collect 有什么区别

可以按数据流方向选择：切片到迭代器用 Values，切片到独立副本用 Clone，迭代器回到切片用 Collect。不要因为函数名都在 slices 包中，就把三者当成同一种转换。

常见问题

slices.Values 会改变原切片吗？

调用 Values 本身不是排序、删除或复制操作；它提供一个按顺序读取元素的序列。原切片是否被改变，取决于后续代码是否通过原切片或元素引用修改数据。

为什么 Values 后面可以直接写 range？

因为它返回的是 iter.Seq[E]，也就是 Go 迭代器约定的单值序列函数类型，符合函数式 range 的消费形式。

什么时候不能只用 Values？

如果消费方会延迟执行、跨 goroutine 使用，或者明确要求数据快照，就应先设计好生命周期并考虑 slices.Clone，不要把对原切片的引用关系隐藏在迭代器之后。