Go中不存在文件作用域变量，所有顶级变量均为包作用域；小写标识符仅包私有而非文件私有，同包多文件可互相访问；真正隔离需用闭包封装局部状态。
Go里没有“文件作用域”变量，只有包作用域
Go语言没有像C/C++的static或Rust的pub(crate)这种“单文件内可见”的顶级变量机制。所有顶级变量（包括var、const、func）的作用域都是整个包（package），只要名字首字母小写，就仅在当前包内可访问——但**不是仅限于当前.go文件**。
为什么小写变量不能跨文件访问？不是文件作用域，是包作用域限制
小写标识符（如counter、dbConn）只是包私有（unexported），同一包下的其他.go文件仍能直接引用它。常见误解是“放在a.go里，b.go就看不到”，实际只要都在package main或同名包下，就能互相访问。
容易踩的坑：
- 误以为把变量移到单独的
internal/子包就能“隔离到文件”，其实只是多了一层包边界，仍需整个子包一起被引用 - 用
init()函数初始化小写变量，结果被同包其他文件提前触发，引发竞态或重复初始化 - 重构时拆分文件，忘了检查同包内其他文件是否已依赖该变量，导致编译失败或行为突变
真正想“锁死在单文件内”，得靠闭包+局部作用域
如果逻辑必须严格绑定到一个文件、且绝对不允许其他文件触碰，唯一可靠方式是：不声明顶级变量，而把状态封装进函数内部，用闭包维持私有数据。
立即学习“go语言免费学习笔记（深入）”；
例如，替代全局var cache map[string]int：
func newCache() func(string) int {
cache := make(map[string]int)
return func(key string) int {
return cache[key]
}
}
var getFromCache = newCache() // 仅本文件能调用 getFromCache
这样cache字面量完全不可导出，连同包其他文件也无法访问其底层映射。
适用场景：
- 纯内部缓存、计数器、配置解析中间态
- 测试辅助变量（比如
testHelper只在xxx_test.go里用） - 需要避免包级初始化顺序依赖时（比如依赖尚未
init()的其他包变量）
别硬凑“文件级可见”，优先考虑包结构设计
Go鼓励按职责而非文件粒度组织代码。与其纠结“怎么藏住一个变量”，不如问：这个状态是否真该属于整个包？是否该抽成独立小包（如pkg/cache）并导出明确接口？
典型反模式：
- 在一个大
main包里塞10个.go文件，全用小写变量通信——后期维护难定位、难测试 - 为隐藏实现，把本该导出的类型和方法全改成小写，结果调用方只能复制粘贴逻辑
真正难处理的从来不是“怎么声明”，而是“这个状态该归属哪一层抽象”。文件只是物理划分，包才是Go的语义边界。
