go 语言要求同一包的所有源文件必须位于同一目录下，无法直接从子目录导入未导出的函数；若需组织控制器逻辑，应将子目录设为独立可导入包，并在 main.go 中显式导入使用。
在 Go 的模块化开发中，目录结构 ≠ 包结构——Go 以 package 声明而非文件路径来界定代码归属。你当前的项目结构中，Controllers/Index.go 和 main.go 虽同属 package main，但因物理路径不同（Index.go 在子目录），Go 编译器会将其视为两个独立的 main 包，导致符号不可见（Index undefined 错误）。这是 Go 的明确设计约束，而非工具链限制。
✅ 正确做法：将控制器抽象为独立可复用包
推荐重构为以下符合 Go 惯例的结构：
/app ├── main.go ├── controllers/ ← 独立包（非 main！） │ └── index.go ├── views/ └── public/
-
创建 controllers/index.go（注意：包名不再是 main）：
// controllers/index.go package controllers
import ( "fmt" "net/http" )
// Index 是导出函数（首字母大写），供其他包调用 func Index(w http.ResponseWriter, r *http.Request) { fmt.Fprintln(w, "Hello from controllers/index.go!") }
2. **更新 `main.go`，显式导入并使用该包**：
```go
// main.go
package main
import (
"log"
"net/http"
"your-module-name/controllers" // 替换为你的实际 module name，如 "example.com/myapp/controllers"
"github.com/gorilla/mux"
)
func main() {
r := mux.NewRouter()
r.HandleFunc("/", controllers.Index) // ✅ 正确引用导出函数
log.Println("Server starting on :8080...")
log.Fatal(http.ListenAndServe(":8080", r))
}⚠️ 关键注意事项：
- controllers/ 目录下的 package controllers 必须与目录名一致；
- 函数名 Index 首字母大写，否则外部包无法访问；
- go mod init your-module-name 是必需步骤（如 go mod init example.com/myapp），确保导入路径解析正确；
- 不要将子目录文件仍声明为 package main —— Go 不允许同一模块存在多个 main 包。
? 进阶提示：
随着项目增长，可进一步按功能拆分控制器包（如 auth/controllers.go、api/v1/posts.go），并通过统一接口或路由注册函数集中管理，提升可维护性。始终遵循 “一个目录一个包” 和 “包名即目录名” 的 Go 最佳实践。
