Go 项目中如何正确组织同一包的多文件目录结构

go 语言要求同一包的所有源文件必须位于同一目录下，无法通过编译器配置将分散在子目录（如 `models/`）中的文件归入 `main` 包；若需逻辑分层，应采用多包设计而非强行共用包名。

在 Go 中，“一个目录对应一个包”是语言工具链（go build、go run 等）的核心约定，而非可选配置。你提出的目录结构：

src/
└── myProject/
    ├── main.go
    └── models/
        ├── foo.go
        └── bar.go

若希望 foo.go 和 bar.go 同属 main 包（即文件顶部都声明 package main）

，则 Go 编译器会直接报错：./models/foo.go:1:1: package main declared in file foo.go is not the same as the package main declared in main.go —— 因为 main.go 和 models/foo.go 处于不同目录，go 工具会将它们视为两个独立包，即使包名相同也不被允许。

✅ 正确做法：遵循 Go 的包组织哲学，按功能拆分为多个包：

src/
└── myProject/
    ├── main.go              # package main
    └── models/              # package models
        ├── foo.go           # package models
        └── bar.go           # package models

main.go 中导入并使用：

// main.go
package main

import (
    "fmt"
    "myProject/models"  // 注意：模块路径需匹配 GOPATH 或 go.mod 定义
)

func main() {
    f := models.NewFoo()
    fmt.Println(f)
}

// models/foo.go
package models

type Foo struct{}

func NewFoo() Foo { return Foo{} }

⚠️ 注意事项：

• 不要试图在 models/ 下写 package main —— 这违反 Go 规范，会导致构建失败；
• 若项目使用 Go Modules（推荐），确保根目录含 go.mod 文件（如 go mod init myProject），此时导入路径为 myProject/models；
• src/ 目录在现代 Go（1.11+ Modules）中已非必需；更惯用的结构是直接以模块根为工作目录：

  myProject/
  ├── go.mod
  ├── main.go
  └── models/
      ├── foo.go
      └── bar.go

? 总结：Go 的目录即包名，这是其简洁性与可维护性的基石。看似“受限”的结构，实则强制清晰的依赖边界和可测试性。拥抱这一约定，比绕过工具链（如手动调用 gc 编译器）更可持续、更符合工程实践。