go 的 internal 机制禁止外部包导入 internal 目录下的包，测试文件必须与被测 internal 包同目录且同包名（如 internal/service/service_test.go 中 package service），才能访问未导出符号；go test ./... 默认跳过 internal，需显式指定 go test ./internal/...。
internal 目录下包无法被外部测试包导入
Go 的 internal 机制是编译期强制约束：只有父目录或祖先目录下的代码能 import internal 子目录。这意味着你写在 test 目录（或任何同级/子级非祖先路径）的测试文件，根本 import 不了 myproject/internal/service —— 编译直接报错：use of internal package not allowed。
常见错误现象：运行 go test ./... 或单独 go test ./internal/service 时失败；手动写测试文件 import internal 包时编辑器标红、go build 报错。
- 正确做法：测试文件必须和被测
internal包放在同一目录下，即internal/service/service_test.go - 不要试图把测试放到
test/、tests/或根目录下再 importinternal—— Go 不允许，没绕过方法 - 如果想跑“集成式”测试（比如模拟 HTTP 调用），可把测试逻辑放在主模块顶层（如
cmd/或根目录），但只能测导出的 public 接口，不能直击internal里的私有函数
如何测试 internal 包里未导出的函数或变量
Go 没有“包内可见但不导出”的访问机制，internal 包里的 func helper() 或 var config 对测试文件来说和对其他包一样——只要在同一个包名下，就能直接用。
关键点在于：测试文件和源文件必须声明相同的 package 名（不是 package main 或 package test），且在同一目录。
立即学习“go语言免费学习笔记（深入）”；
- 例如
internal/cache/cache.go是package cache，那测试文件必须叫internal/cache/cache_test.go，且首行是package cache - 这样
cache_test.go就能直接调用newLRU()（哪怕它小写）、读写defaultTTL变量 - 别加
_test后缀到包名里（如package cache_test）——那是为测试外部包准备的，会切断对本包私有符号的访问
go test ./... 找不到 internal 下的测试
默认情况下 go test ./... 会跳过所有 internal 目录，这是 Go 工具链的隐式行为，不是 bug。
原因：Go 认为 internal 是实现细节，./... 默认只扫描顶层可导入路径（即不含 internal、vendor 等特殊目录）。
- 显式指定路径：用
go test ./internal/...或go test ./internal/cache - 确认测试文件存在且命名规范：
*_test.go，且包名与源码一致 - 避免在
internal目录下放main.go或go.mod—— 这会让 Go 认为它是独立 module，彻底隔离测试发现
mock internal 依赖时容易误用 go:generate 或第三方工具
有人想 mock internal/db 给 internal/handler 测试用，结果引入 gomock 或 mockgen，却发现 interface 定义在 internal 里，生成的 mock 代码无法被 handler_test.go import —— 又撞回权限墙。
根本解法不是绕过 internal，而是调整抽象位置：
- 把要 mock 的 interface 提前定义在上层 public 包里（如
pkg/repo），让internal/db实现它，internal/handler依赖该 interface - 或者用函数变量替代 interface：在
handler包里定义var newDBClient = func() DBer { return &realDB{} }，测试时直接赋值newDBClient = func() DBer { return &mockDB{} } - 别在
internal里生成 mock 代码再试图 export —— Go 不允许，生成的文件也进不了构建流程
internal 的边界感很硬，软化它的唯一可靠方式是把契约（interface / func sig）放在外面，实现藏在里面。这点容易被忽略，一卡就是半天。
