在 Go 语言中，函数是否可访问取决于其作用域（包级）而非文件位置；只要 main.go 和 mapping.go 属于同一包，小写开头的私有函数（如 buildIndexMapping）即可被该包内任意源文件直接调用，无需显式导入。
在 go 语言中，函数是否可访问取决于其作用域（包级）而非文件位置；只要 `main.go` 和 `mapping.go` 属于同一包，小写开头的私有函数（如 `buildindexmapping`）即可被该包内任意源文件直接调用，无需显式导入。
Go 的可见性规则以首字母大小写为唯一判定标准：
- 首字母大写（如 BuildIndexMapping）→ 导出（exported），可在其他包中通过 package.FuncName 访问；
- 首字母小写（如 buildIndexMapping）→ 非导出（unexported），仅在定义它的包内可见，与所在文件无关。
这意味着：
✅ 同一包下的多个 .go 文件（如 main.go、mapping.go、utils.go）共同构成一个逻辑单元；
✅ 所有非导出标识符（函数、变量、类型、方法等）在包内全局共享、自由调用；
❌ 不存在“文件级作用域”或“隐式导入”概念——Go 不支持按文件导入，只支持按包导入（import "path/to/pkg"）。
以 blevesearch/beer-search 为例：
- main.go 和 mapping.go 均声明为 package main；
- mapping.go 中定义的 func buildIndexMapping(...) { ... } 是包内私有函数；
- 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("Index mapping: %+v\n", mapping)
}⚠️ 注意事项：
- 若将 mapping.go 移至其他包（如 package mapping），则 main.go 必须通过 import "your-module/mapping" 引入，并只能调用其导出函数（即首字母大写的 BuildIndexMapping）；
- Go 编译器会自动聚合同一包下所有 .go 文件，最终生成单个包对象——这是语言设计的核心约定，不是“隐式行为”，而是明确规范；
- 使用 go build 或 go run 时，工具链自动识别当前目录及子目录中所有 package main 文件（除非被构建标签排除），无需手动列举源文件。
总结：Go 的模块化以包（package）为最小可见性边界，文件仅为组织物理代码的单位。理解这一原则，是写出清晰、可维护 Go 项目的基础。
