Go 项目运行 go test 时提示找不到 github.com/stretchr/testify/assert，根本原因是该第三方测试工具未被下载安装到本地模块或 GOPATH 中，仅声明 import 不会自动获取依赖。

go 项目运行 `go test` 时提示找不到 `github.com/stretchr/testify/assert`，根本原因是该第三方测试工具未被下载安装到本地模块或 gopath 中，仅声明 import 不会自动获取依赖。

在 Go 中，import 语句仅声明代码依赖关系，不会自动下载或安装包。当执行 go test（或 go build、go run）时，Go 工具链会按以下顺序查找包：

• 当前模块的 vendor/ 目录（若启用 vendor 模式）；
• $GOROOT/src（标准库路径）；
• $GOPATH/src（旧式 GOPATH 模式）；
• 或 Go Modules 模式下的 go.mod 所管理的缓存（如 ~/go/pkg/mod）。

你遇到的错误明确显示三处均未找到 github.com/stretchr/testify/assert，说明该包尚未安装。

✅ 正确解决方式（推荐使用 Go Modules）：

1. 确保项目已初始化为 Go Module（Go 1.11+ 默认启用）：
   若尚无 go.mod 文件，先运行：

   go mod init github.com/[group_name]/[project_name]

2. 安装 testify/assert 包：
   执行以下任一命令（效果相同，推荐带 -u 更新至最新兼容版）：

   go get -u github.com/stretchr/testify/assert

   或（更精准地只添加测试依赖，Go 1.21+ 推荐）：

   go get -u -t github.com/stretchr/testify/assert

   ✅ 此操作会：

   • 自动下载包及其依赖；
   • 将其版本写入 go.mod（如 require github.com/stretchr/testify v1.9.0）；
   • 缓存至本地 ~/go/pkg/mod，供后续构建复用。

3. 验证是否生效：
   运行测试应不再报错：

   go test ./...

⚠️ 注意事项：

• 避免混用 GOPATH 和 go mod：若项目含 go.mod，请勿依赖 $GOPATH/src 手动放置源码；
• vendor/ 目录需显式生成：如需锁定依赖，运行 go mod vendor，之后测试将优先从 vendor/ 加载；
• 若使用旧版 Go（GO111MODULE=auto 可能失效，建议显式启用：export GO111MODULE=on。

? 小贴士：testify/assert 是纯测试辅助库，建议在 //go:build test 构建约束下导入，或统一放在 _test.go 文件中，避免污染生产依赖。例如：

// helper_test.go
package lib

import "github.com/stretchr/testify/assert"

至此，go test 即可正常识别并使用断言功能，错误彻底解决。