在 go 语言中，函数是否可被访问取决于其作用域（包级可见性），而非文件位置；只要位于同一包内，小写开头的私有函数即可被该包内任意源文件直接调用，无需显式导入或声明。
在 go 语言中，函数是否可被访问取决于其作用域（包级可见性），而非文件位置；只要位于同一包内，小写开头的私有函数即可被该包内任意源文件直接调用，无需显式导入或声明。
Go 的可见性规则基于标识符首字母大小写，而非文件系统结构或显式导入语句。具体而言：
- ✅ 首字母大写（如 BuildIndexMapping）：导出（exported）标识符，对其他包可见，需通过包名访问（如 mapping.BuildIndexMapping）；
- ✅ 首字母小写（如 buildIndexMapping）：未导出（unexported）标识符，仅在定义它的包内部可见，且不受文件边界限制。
以 blevesearch/beer-search 为例：
- main.go 和 mapping.go 均声明为 package main；
- mapping.go 中定义了未导出函数 func buildIndexMapping() map[string]interface{}；
- main.go 中直接调用 buildIndexMapping() —— 完全合法且无需任何 import 语句。
// mapping.go
package main
func buildIndexMapping() map[string]interface{} {
return map[string]interface{}{
"properties": map[string]interface{}{
"name": map[string]string{"type": "text"},
},
}
}// main.go
package main
import "fmt"
func main() {
mapping := buildIndexMapping() // ✅ 正确：同包内直接调用私有函数
fmt.Printf("Mapping: %+v\n", mapping)
}⚠️ 注意事项：
- Go 没有“文件级作用域”：.go 文件仅是编译单元，不是命名空间；所有同包 .go 文件共同构成一个逻辑包；
- import 语句只用于引入其他包（如 "fmt"、"os"），永远不能也不需要 import "./mapping" 或类似写法；
- 若将 buildIndexMapping 移至独立包（如 package mapping），则必须导出（改为 BuildIndexMapping）并使用 import "github.com/blevesearch/beer-search/mapping" 才能在 main.go 中调用；
- 构建时，go build 会自动聚合同一目录（及子目录中 go:embed 或 //go:generate 相关）下所有属于该包的 .go 文件。
✅ 总结：Go 的包是唯一的作用域边界。只要多个源文件共享相同的 package xxx 声明，它们就处于同一编译单元，彼此可自由访问所有未导出标识符——这是 Go 简洁模块化设计的核心体现，也是理解其依赖管理与代码组织的关键前提。
