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），否则无法被其他包访问。
遵循这一设计原则，不仅能解决跨包调用问题，更能提升代码可测试性、可维护性与模块复用能力。Go 的“单一职责”哲学正体现在此处：main 是胶水，不是仓库。
