如何在 Go 中跨包调用函数：避免从 main 包导出的常见误区-Golang-PHP中文网

如何在 Go 中跨包调用函数：避免从 main 包导出的常见误区

go 语言中，main 包仅用于程序入口，不可被其他包导入；需将可复用逻辑提取至独立包，再由 main 和其他包共同导入。

go 语言中，main 包仅用于程序入口，不可被其他包导入；需将可复用逻辑提取至独立包，再由 main 和其他包共同导入。

在 Go 工程实践中，main 包具有特殊语义：它标识一个可执行程序的入口点，不能被其他包导入。因此，当你尝试在 postgres 包中通过 import "foo/src" 调用 main 包中的函数时，编译器报错 import "foo/src" is a program, not an importable package —— 这并非路径配置问题，而是 Go 语言的设计约束。

✅ 正确做法：重构为可复用包

将原本定义在 main 包中、但被 postgres 包（或其他包）依赖的函数，迁移至一个独立的、命名清晰的包中，例如 internal/utils 或 pkg/database。目录结构建议如下：

foo/
├── cmd/
│   └── app/               # 主程序入口（package main）
│       └── main.go
├── pkg/
│   └── database/          # 可导出的业务逻辑（package database）
│       └── dbutils.go
└── postgres/              # 原 postgres 文件夹（package postgres）
    └── client.go

示例：提取通用数据库初始化函数

// pkg/database/dbutils.go
package database

import "fmt"

// InitDB 是可被多个包复用的函数
func InitDB(dsn string) error {
    fmt.Printf("Initializing DB with DSN: %s\n", dsn)
    // 实际连接逻辑...
    return nil
}

// cmd/app/main.go
package main

import (
    "foo/pkg/database"
)

func main() {
    _ = database.InitDB("postgresql://...")
}

// postgres/client.go
package postgres

import (
    "foo/pkg/database"
)

func Connect() error {
    return database.InitDB("postgresql://localhost/mydb")
}

⚠️ 注意事项

❌ 不要将业务逻辑、工具函数、配置解析等放入 main 包；
✅ main 包应保持极简：仅负责解析 flag、初始化依赖、启动服务；
? 若项目已有大量 main 中的函数，可先创建 internal/ 或 pkg/ 子模块，逐步迁移；
? 包路径必须对应文件系统结构（如 foo/pkg/database 对应 ./pkg/database/），且需确保 go.mod 已初始化（go mod init foo）；
? 所有导出函数/类型首字母必须大写（如 InitDB），否则无法被其他包访问。