私有函数在Go中需同包测试：测试文件应与源文件同属一个包（如均声明package utils），而非使用package utils_test；仅当逻辑复杂、被多处复用或具明确契约时才需直接测试私有函数。
私有函数在Go中无法被外部包直接测试
Go语言通过首字母大小写控制标识符可见性，以小写字母开头的函数（如 validateInput）仅在定义它的包内可访问。这意味着其他包（包括同目录下的 xxx_test.go 文件，只要它属于不同包名）无法调用该函数——哪怕测试文件和源文件在同一目录下，若包声明为 package mypkg 和 package mypkg_test，就已构成两个独立包，私有函数不可见。
正确做法：让测试文件与源文件同属一个包
只需将测试文件的包声明改为与源文件一致（即去掉 _test 后缀），就能直接访问私有函数。这是官方推荐且最轻量的方式，无需导出、不破坏封装意图。
- 源文件
utils.go声明package utils - 对应测试文件应命名为
utils_test.go，但包声明必须是package utils（不是utils_test） - 此时
go test仍能正常发现并运行该测试（Go工具链支持同包测试文件） - 注意：这种测试属于“包内测试”，不会被其他包 import，也不影响 API 稳定性
package utils
import "testing"
func TestValidateInput(t *testing.T) {
if !validateInput("abc") {
t.Error("expected true for non-empty string")
}
}
什么时候不该测私有函数？
并非所有私有函数都值得单独测试。重点应放在：逻辑复杂、有明确输入输出契约、或被多个公有函数复用的私有函数上。
- 纯辅助型小函数（如
clamp(x, min, max)）可通过覆盖其调用方的公有函数间接验证 - 含副作用的私有函数（如修改包级变量、写文件）需谨慎：若测试时污染状态，可能引发偶发失败
- 若私有函数因重构频繁变动，而测试强绑定其实现细节，会导致测试脆弱——此时更应测试公有接口的行为边界
- 想测但发现难以构造输入/断言输出？往往是函数职责过重或依赖隐式（如全局 logger、time.Now()），应先解耦（传入 interface 或函数参数）
替代方案：导出 + internal 包隔离（适合跨包复用场景）
当某组私有逻辑确实需要被多个包共享，又不想暴露给最终用户时，可将其提取到 internal/ 子目录中，并导出函数。Go 的 internal 机制会阻止外部模块 import 它。
- 目录结构示例：
myapp/internal/validator/validator.go，其中定义func ValidateInput(...) - 该函数可被
myapp/cmd和myapp/api导入使用，但无法被github.com/other/user导入 - 此时测试文件可放在
internal/validator/validator_test.go，包名为validator，直接调用导出函数 - 注意：
internal是编译期检查，不是运行时保护；路径必须严格匹配（/internal/作为路径片段）
测试私有函数本身不难，难的是判断“是否真有必要测”以及“测了之后能否长期维护”。很多看似“无法测试”的卡点，其实源于函数职责不清或依赖固化——先理清边界，再选工具，比强行加测试更有价值。
