Go t.Setenv 测试 os.UserHomeDir 的环境读取边界

测试配置文件、缓存目录或密钥路径时，代码经常通过 os.UserHomeDir() 找到当前用户主目录。直接读取开发机上的 HOME 会让测试依赖运行环境，换到 CI 或 Windows 就可能失真。更稳妥的做法是：按平台选择环境变量，用 t.TempDir() 创建临时目录，再用 t.Setenv() 注入并断言返回值。

先固定 UserHomeDir 的平台读取边界

os.UserHomeDir 不是从当前工作目录推导路径。官方实现会按平台选择环境变量：Unix（包括 macOS）读取 HOME，Windows 读取 USERPROFILE，Plan 9 读取 home。读取到非空值时直接返回；预期变量为空时通常返回错误，Android 和 iOS 则有平台特例。因此测试辅助函数不能把 HOME 写死成所有系统都适用的键。

package homedir_test

import (
    "os"
    "runtime"
    "testing"
)

func homeEnvKey() string {
    // UserHomeDir 的变量名随运行平台变化，测试先统一选择键名。
    switch runtime.GOOS {
    case "windows":
        return "USERPROFILE"
    case "plan9":
        return "home"
    default:
        return "HOME"
    }
}

func TestUserHomeDirReadsInjectedPath(t *testing.T) {
    tempHome := t.TempDir()
    t.Setenv(homeEnvKey(), tempHome)

    got, err := os.UserHomeDir()
    if err != nil {
        t.Fatalf("读取临时主目录失败: %v", err) // 先报告平台或环境错误。
    }
    if got != tempHome {
        t.Fatalf("主目录 = %q，想要 %q", got, tempHome) // 防止测试悄悄读到真实目录。
    }
}

这里的临时目录只作为输入，不要求提前创建任何配置文件。t.TempDir 会登记自动清理，t.Setenv 会登记环境恢复；测试只验证“函数读取了注入值”，不会触碰开发者真实的主目录。

把合法路径和空值错误拆成两条断言

“环境变量存在”和“环境变量有可用值”不是一回事。用 t.Setenv(key, "") 可以覆盖空值分支；它不是删除变量，但 UserHomeDir 读取到空字符串后会进入未定义处理。对 Android、iOS 等平台不要硬编码错误文本，测试应根据平台能力决定是否跳过或只验证返回值约束。

func TestUserHomeDirRejectsEmptyValue(t *testing.T) {
    // 移动系统可能提供平台默认主目录，不能套用 Unix 的错误断言。
    if runtime.GOOS == "android" || runtime.GOOS == "ios" {
        t.Skip("当前平台对空主目录有默认值")
    }
    t.Setenv(homeEnvKey(), "")

    got, err := os.UserHomeDir()
    if err == nil {
        t.Fatalf("空环境值仍返回主目录 %q", got) // 空值不应被当作测试夹具成功输入。
    }
    if got != "" {
        t.Fatalf("错误时仍返回路径 %q", got) // 保持错误结果的边界清楚。
    }
}

不要断言完整错误字符串来锁死实现细节；如果业务只关心“拿不到目录就停止初始化”，检查 err != nil 和空路径即可。若应用需要区分未设置、空值和路径不存在，应在自己的配置层保存更明确的错误类型，而不是把标准库错误文本当作长期协议。

用非并行父测试收好 Cleanup 边界

t.Setenv 改的是整个测试进程的环境，所以不能在调用了 t.Parallel() 的测试中使用，也不能放在有并行祖先的测试里。需要并行跑表格用例时，可以把环境相关用例单独放在非并行分组，把纯函数或不读进程环境的用例放进并行分组。

func TestHomeDependentCases(t *testing.T) {
    // 父测试不调用 t.Parallel，让环境变量只在这组生命周期内变化。
    t.Run("injected-home", func(t *testing.T) {
        tempHome := t.TempDir()
        t.Setenv(homeEnvKey(), tempHome)
        got, err := os.UserHomeDir()
        if err != nil || got != tempHome {
            t.Fatalf("主目录读取结果 = %q, %v", got, err) // 失败时同时保留路径和错误。
        }
    })
}

这里没有手写 os.Setenv 和恢复逻辑，减少了忘记恢复、恢复顺序错误以及失败分支漏清理的可能。若被测函数在后台 goroutine 中异步读取环境，仍应先让 goroutine 在子测试返回前结束，否则 Cleanup 执行后它可能看到另一套环境。

常见问题

为什么不用直接设置 HOME？

直接调用 os.Setenv 会把恢复责任交给测试作者，失败路径和并发场景更容易污染后续用例；t.Setenv 将恢复动作绑定到测试生命周期。

t.TempDir 能代替 t.Setenv 吗？

不能。t.TempDir 只负责创建和删除目录，t.Setenv 才负责让 UserHomeDir 读到这个目录，两者解决的是不同边界。

Windows 测试为什么设置 HOME 后仍然不生效？

因为 os.UserHomeDir 在 Windows 读取的是 USERPROFILE。用平台选择函数设置对应键名，测试才能表达真实行为。