本文介绍如何在 Go 单元测试中，将普通字符串快速、安全地转换为符合 io.Reader 接口的实例，从而替代真实网络连接（如 TCP），实现对依赖 io.Reader 的结构体的可重复、无副作用测试。
本文介绍如何在 go 单元测试中，将普通字符串快速、安全地转换为符合 `io.reader` 接口的实例，从而替代真实网络连接（如 tcp），实现对依赖 `io.reader` 的结构体的可重复、无副作用测试。
在 Go 的接口设计中，io.Reader 是最基础且广泛使用的输入抽象之一。许多核心库（如 encoding/json、net/http）及业务代码都通过接收 io.Reader 来解耦数据源——无论是文件、网络流还是内存缓冲区。但在编写单元测试时，我们通常不希望引入真实 I/O（如启动 TCP 服务或读取磁盘文件），而应使用纯内存、确定性、零依赖的模拟输入。
Go 标准库已为此场景提供了开箱即用的解决方案：strings.Reader。它是一个轻量、高效、线程安全的类型，完整实现了 io.Reader、io.Seeker、io.ReaderAt 和 io.ByteReader 等多个接口，特别适合测试用途。
只需调用 strings.NewReader(s string)，即可将任意字符串转为 io.Reader 实例：
package main
import (
"strings"
"testing"
)
func TestMyStructWithMockInput(t *testing.T) {
s := "this is my input"
reader := strings.NewReader(s) // ✅ 符合 io.Reader 接口
tStruct := NewTestStruct(reader)
result := tStruct.doSomething()
// 断言逻辑...
if result != expected {
t.Errorf("expected %v, got %v", expected, result)
}
}
⚠️ 注意事项：
- strings.NewReader 返回的是值类型（strings.Reader），其内部维护读取偏移量；多次调用 Read() 会自动推进位置，行为与真实流一致；
- 若需重复读取同一字符串（例如多次调用 doSomething()），应在每次测试前重新创建 strings.NewReader(s)，或使用 reader.Seek(0, io.SeekStart) 重置位置（因 strings.Reader 同时实现了 io.Seeker）；
- 切勿使用 bytes.NewReader([]byte(s)) 替代：虽然它也实现 io.Reader，但 []byte 是可变底层数组，若被误修改可能导致测试污染；而 strings.Reader 基于不可变 string，更安全、内存更紧凑；
- 不要尝试 io.NewReader(s) —— 此函数不存在于标准库中，是常见误解（io 包中无 NewReader 函数）。
总结：strings.NewReader 是 Go 测试实践中处理字符串 → io.Reader 转换的标准、推荐且唯一官方方案。它简洁、可靠、无额外依赖，是编写可维护、高性能单元测试的关键基础设施。
