同一package main下跨目录调用函数报错，多二进制构建问题排查

嘿，这个问题我刚踩过不久！其实你误解了Go的包机制——虽然你把所有文件都声明成了package main，但Go编译器默认只会把同一个目录下的同包名文件视作同一个包的一部分。跨目录的同包名文件，编译器是不会自动帮你关联起来的，这就是为什么你会看到undeclared name的错误。

为什么会出现这个问题？ #

Go的包管理本质上是和目录绑定的：

• 同一个逻辑包的文件应当放在同一个目录下，编译器在构建时只会扫描当前目录（以及你显式指定的文件）来组成一个包。
• main包是特殊的入口包，每个main包对应一个可执行二进制文件，所以你要构建多个二进制的场景下，每个二进制的入口main.go应该在独立目录，而共享逻辑不该放在main包里。

推荐的解决方案（标准做法） #

把共享代码抽成独立的非main包，这是Go社区的最佳实践：

1. 重构共享代码的包名
   把根目录的xxx.go、yyy.go、zzz.go的包声明改成一个有意义的名字，比如package common，同时要把需要被外部调用的函数名首字母改成大写（Go只有大写开头的标识符才能被其他包访问）。
   比如xxx.go里的函数：

   // 原来的小写函数名，只能在同包内访问
   // func xxx() { ... }
   // 修改为大写，允许外部包调用
   func Xxx() {
       // 函数逻辑
   }
   

2. 在入口文件中导入共享包
   先在项目根目录初始化模块（如果还没做）：

   go mod init your-module-name
   

   然后在cmd/program1/main.go里导入这个共享包：

   package main
   
   import "your-module-name/common"
   
   func main() {
       // 调用共享包的函数
       common.Xxx()
       common.Yyy()
   }
   

3. 编译运行
   现在你可以直接在cmd/program1目录下运行：

   go run main.go
   

   或者在项目根目录构建所有二进制：

   go build ./cmd/program1
   go build ./cmd/program2
   

临时解决方案（不推荐长期使用） #

如果你非要坚持用同一个main包，可以在编译时手动指定所有需要的文件：
在项目根目录运行：

# 运行program1
go run ./cmd/program1/main.go ./xxx.go ./yyy.go ./zzz.go

# 构建program1二进制
go build -o program1 ./cmd/program1/main.go ./xxx.go ./yyy.go ./zzz.go

这种方法的弊端很明显：每次新增共享文件都要手动添加到命令里，代码结构混乱，不符合Go的设计理念，只适合临时测试。

总的来说，把共享逻辑抽成独立包是更合理的选择，既能解决跨目录调用问题，也能让你的项目结构更清晰易维护。

内容的提问来源于stack exchange，提问作者Jill Clover