在 Go 语言中，以小写字母开头的函数（如 buildIndexMapping）虽为私有（unexported），但只要定义与调用位于同一包内，无需显式导入文件即可直接使用——因为 Go 的作用域单位是包而非文件。
在 go 语言中，以小写字母开头的函数（如 `buildindexmapping`）虽为私有（unexported），但只要定义与调用位于同一包内，无需显式导入文件即可直接使用——因为 go 的作用域单位是包而非文件。
Go 的可见性规则（visibility rule）由标识符首字母大小写决定：首字母大写表示导出（exported），可被其他包访问；首字母小写表示未导出（unexported），仅在定义它的包内可见。值得注意的是，这一规则与文件无关——Go 没有“文件级作用域”或“隐式文件导入”的概念。只要多个 .go 文件声明了相同的 package 名（例如均为 main），它们就共同构成一个逻辑包，彼此共享全部未导出的标识符。
以 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{}{
"name": "beer",
"type": "document",
}
}// main.go
package main
import "fmt"
func main() {
m := buildIndexMapping() // ✅ 合法：同包内访问未导出函数
fmt.Printf("%v\n", m)
}❌ 跨包调用将编译失败：
// otherpkg/other.go
package otherpkg
import "your-project/main" // ❌ 无法导入未导出函数
func foo() {
// main.buildIndexMapping() // 编译错误：cannot refer to unexported name main.buildIndexMapping
}⚠️ 注意事项：
- Go 不支持“按文件导入”，import 语句只用于引入其他包（如 "fmt"、"net/http"），从不用于引入同一包内的 .go 文件；
- 同包多文件编译时，Go 工具链自动聚合所有文件（按 go build . 或 go run *.go），无需额外配置；
- 若出现 undefined: buildIndexMapping 错误，请检查：① 是否拼写一致；② 两文件 package 声明是否完全相同（包括空格）；③ 是否存在构建约束（如 //go:build ignore）导致某文件未参与编译。
总结：Go 的模块化基石是包（package），而非文件。理解“包内私有即全局可见”这一原则，是写出结构清晰、符合 Go 惯例代码的关键前提。
