go 语言通过首字母大小写严格控制标识符的可见性：首字母大写的函数、类型或变量才能被其他包访问，小写则为包内私有。这是 go 包机制的核心约定，而非语法限制。
go 语言通过首字母大小写严格控制标识符的可见性：首字母大写的函数、类型或变量才能被其他包访问，小写则为包内私有。这是 go 包机制的核心约定，而非语法限制。
在 Go 中，导出（exported）与非导出（unexported）标识符的区分完全取决于名称的首字母是否为大写——这被称为“导出规则”（Export Rule）。该规则适用于函数、变量、常量、类型（如 struct、interface）、以及结构体字段等所有声明项。
例如，您在 libraries/test/test.go 中定义的函数：
// test.go（位于 libraries/test/ 目录下）
package test
import "fmt"
func foo() { // ❌ 首字母小写 → 非导出 → 仅 test 包内可见
fmt.Println("foo")
}
func Foo() { // ✅ 首字母大写 → 导出 → 可被其他包调用
fmt.Println("Foo")
}
当 main.go 尝试通过 test.foo() 调用时，编译器会报错：
./main.go:7: cannot refer to unexported name test.foo ./main.go:7: undefined: test.foo
原因正是 foo 是非导出名称，Go 编译器禁止跨包访问它，即使导入路径正确、包名无误。
✅ 正确做法是将函数名改为 Foo（遵循 PascalCase），并同步更新调用处：
// main.go
package main
import (
"./libraries/test" // 注意：此相对路径导入仅适用于早期 Go 版本或非模块环境；现代项目推荐使用 Go Modules
)
func main() {
test.Foo() // ✅ 可成功编译运行
}
⚠️ 重要注意事项：
- 路径导入不等于包可见性：即使 import "./libraries/test" 语法能通过解析，也无法绕过导出规则；
- 模块化建议：在 Go 1.11+ 的模块化项目中，应避免使用相对路径导入（如 ./libraries/test）。推荐将 libraries/test 初始化为子模块，或统一置于 $GOPATH/src 或通过 go mod init 建立主模块后，使用规范的导入路径（如 example.com/myapp/libraries/test）；
- 命名即契约：Foo 不仅表示“可导出”，更向使用者传达“这是一个公共 API”，应配合文档和稳定性承诺；
- 结构体字段同理：若 type Person struct { Name string; age int }，则 p.Name 可访问，p.age 在外部包中不可见。
总结：Go 的导出机制是其封装性和健壮性的基石。牢记 “首字母大写 = 公共，小写 = 私有” 这一铁律，不仅能解决编译错误，更是编写可维护、可演化的 Go 代码的前提。
