Go 不会自动编译当前目录下所有 .go 文件，go run main.go 仅编译指定文件；要运行含多个源文件的程序，需显式列出全部 .go 文件（如 go run *.go）或使用模块构建方式。
go 不会自动编译当前目录下所有 `.go` 文件，`go run main.go` 仅编译指定文件；要运行含多个源文件的程序，需显式列出全部 `.go` 文件（如 `go run *.go`）或使用模块构建方式。
在 Go 项目开发中，将代码拆分为多个文件（如 main.go、handlers.go、routes.go）是良好实践，但初学者常因忽略 Go 的构建机制而遇到类似 undefined: NewRouter 或 undefined: main.main 的编译错误。根本原因在于：go run 默认只编译并执行你显式指定的 .go 文件，不会自动包含同目录下的其他源文件——即使它们同属 package main。
✅ 正确运行多文件 Go 程序的方法
1. 显式指定所有 .go 文件
在项目根目录（即包含 main.go 的 EdData/ 目录）下执行：
go run main.go handlers.go routes.go
或使用通配符（确保当前目录下无非主程序文件，如测试文件或工具脚本）：
go run *.go
⚠️ 注意：go run *.go 仅适用于 Unix/Linux/macOS；Windows 用户需手动列出文件，或改用 go build && ./program 流程。
2. 使用 go build + 执行（推荐用于调试与部署）
go build -o eddata . ./eddata
该方式先编译整个 main 包（自动发现并链接所有 package main 的 .go 文件），生成可执行文件，更接近生产环境行为，也便于排查依赖问题。
3. 确保文件结构与包声明一致
- 所有文件（main.go、handlers.go、routes.go）必须声明为 package main；
- 不得存在重复的 func main()（目前只有 main.go 定义了 main，符合要求）；
- 函数/变量跨文件调用时，首字母需大写（如 NewRouter、Index 已正确导出）。
✅ 验证你的文件是否满足： | 文件 | 关键检查点 | |------|------------| | handlers.go | Index 函数首字母大写 ✅，且无语法错误 | | routes.go | NewRouter 导出 ✅，routes 变量定义在函数外 ✅，Index 已被 handlers.go 声明 ✅ | | main.go | 仅含 main 入口及辅助函数（如 checkErr），无未定义引用 ✅ |
? 常见错误溯源示例
- 报错 ./main.go:11: undefined: NewRouter → routes.go 未参与编译；
- 报错 Index is undefined（编译 routes.go 单独执行时）→ go run routes.go 缺少 handlers.go，且 routes.go 无 main 函数，无法独立运行；
- 报错 runtime.main: undefined: main.main（编译 handlers.go 时）→ 该文件不含 main 函数，不能作为入口。
? 最佳实践建议
- 始终在模块根目录操作：确保 go run 或 go build 在 EdData/ 目录下执行（即 main.go 所在路径），而非子目录（如 dataEntry/）；
- 初始化 Go 模块（推荐）：运行 go mod init eddata 生成 go.mod，便于后续管理依赖（如 github.com/gorilla/mux）；
- 避免 go run 于大型项目：多文件时易遗漏，建议统一使用 go build 或集成到 Makefile / IDE 运行配置中。
完成以上步骤后，你的 REST API 将成功启动：
$ go run *.go 2024/06/15 10:30:22 Listening on :8080
访问 http://localhost:8080 即可看到 "WELCOME!" —— 多文件 Go 程序已正确协同工作。
