在Golang的项目开发中，我们经常会把不同功能的代码拆分到不同的package中，来实现代码的模块化管理。但不少开发者在尝试跨包调用函数时，会遇到编译报错的情况，这本质上是对Golang的package访问权限规则不够熟悉导致的。
Golang package访问权限的核心规则
Golang没有像Java那样的public、private、protected显式访问修饰符，它的访问控制完全通过标识符的首字母大小写来判定：
- 首字母大写的标识符（函数、结构体、变量、常量等）是导出的，可以被其他包访问
- 首字母小写的标识符是未导出的，只能在当前包内部访问
这个规则适用于所有包级别的标识符，函数作为最常见的标识符类型，自然也遵循这个规则。
跨包调用函数报错的常见原因
1. 被调用的函数首字母小写
这是最容易出现的问题，比如我们在utils包中定义了一个首字母小写的工具函数：
// utils包下的utils.go文件
package utils
// 首字母小写，未导出函数
func add(a int, b int) int {
return a + b
}
此时如果在main包中尝试调用这个函数，就会直接编译报错：
// main包下的main.go文件
package main
import "testproject/utils" // 假设项目模块名为testproject
func main() {
// 尝试调用utils包的add函数，会报错：undefined: utils.add
res := utils.add(1, 2)
println(res)
}
2. 导入包的路径错误
如果导入的包路径不正确，编译器找不到对应的包，自然也无法调用包内的函数，这种情况的报错通常是cannot find package。比如上面的例子中，如果导入路径写成了import "utils"，而实际项目模块路径下没有这个包，就会触发报错。
3. 循环导入导致包不可用
如果两个包互相导入，形成循环依赖，编译器会直接报错import cycle not allowed，此时两个包都无法正常编译，自然也无法调用对方的函数。比如packageA导入packageB，同时packageB又导入packageA，就会出现这个问题。
对应的解决方法
解决函数未导出的问题
如果需要跨包调用函数，只需要把函数的首字母改成大写即可：
// utils包下的utils.go文件
package utils
// 首字母大写，导出函数
func Add(a int, b int) int {
return a + b
}
此时在main包中就可以正常调用了：
// main包下的main.go文件
package main
import "testproject/utils"
func main() {
res := utils.Add(1, 2)
println(res) // 输出3，调用正常
}
解决导入路径错误的问题
导入包时需要使用正确的相对或绝对路径，Go Modules项目下需要使用完整的模块路径加包路径。比如项目模块名为testproject，utils包在项目根目录的utils文件夹下，导入路径就应该是testproject/utils。
解决循环导入的问题
循环导入的本质是包的设计不合理，需要调整代码结构，把两个包互相依赖的部分抽到一个公共的第三方包中，或者把依赖的逻辑下沉到其中一个包，打破循环依赖的关系。
其他需要注意的访问权限细节
除了函数之外，结构体的字段、方法也遵循同样的规则：
- 结构体首字母小写，其他包无法声明该结构体的实例
- 结构体首字母大写，但字段首字母小写，其他包可以声明实例，但无法访问该字段
比如下面的例子：
package utils
// 首字母大写的结构体
type User struct {
Name string // 首字母大写，可导出字段
age int // 首字母小写，未导出字段
}
// 结构体方法，首字母大写可导出
func (u User) GetAge() int {
return u.age
}
在main包中调用时：
package main
import "testproject/utils"
func main() {
u := utils.User{
Name: "张三",
// age: 18, // 报错，无法访问未导出字段
}
// u.age // 报错，无法访问未导出字段
println(u.GetAge()) // 可以通过导出的方法访问未导出字段的值
}
只要牢记首字母大小写决定访问权限这个核心规则，就可以避免绝大多数Golang跨包调用函数报错的问题。