本文详细阐述go app engine项目的推荐目录结构和包管理策略。核心在于理解gopath的作用，以及所有go包应置于gopath/src目录下的规范。遵循此结构能确保项目内包的正确导入、编译与部署，避免常见的“包未定义”错误，从而构建清晰、可维护的app engine应用。
1. 理解 Go 工作区与 GOPATH
Go 语言的开发环境依赖于一个称为“工作区”（Workspace）的概念，其核心是GOPATH环境变量。GOPATH指向你的Go项目根目录，它指导Go工具链在哪里查找源代码、编译后的包以及可执行文件。对于App Engine项目而言，遵循Go标准的工作区约定至关重要。
关键点：
- GOPATH可以设置为任何你喜欢的目录，例如 /home/user/go 或 C:\Users\User\go。
- 在该GOPATH目录下，必须包含一个名为 src 的子目录。所有Go源代码文件，无论是第三方库还是你自己的项目包，都应放置在 src 目录下。
- 尽管Go App Engine的官方教程可能没有明确指出，但其项目编译和运行机制依然遵循Go语言的这一基本工作区规范。
2. Go App Engine 项目的推荐目录结构
为了确保项目内包的正确识别和导入，Go App Engine 项目的目录结构应与标准的Go工作区结构保持一致。这意味着你的应用代码，包括app.yaml和主程序文件，以及所有自定义包，都应位于GOPATH/src之下。
以下是一个推荐的项目结构示例，假设你的GOPATH设置为 /myproject：
/myproject ├── src │ ├── MyApp/ # Go App Engine 应用的根目录 │ │ ├── app.yaml # App Engine 配置文件 │ │ └── myappmain.go # 应用的主入口文件 │ ├── items/ # 自定义包：处理商品逻辑 │ │ └── items.go │ └── router/ # 自定义包：处理路由逻辑 │ └── router.go ├── pkg/ # 编译后的包文件 (Go 工具自动生成) └── bin/ # 编译后的可执行文件 (Go 工具自动生成)
结构说明：
- /myproject: 这是你的 GOPATH。
- /myproject/src: 所有Go源代码的根目录。
- /myproject/src/MyApp: 这是你的具体App Engine应用目录。app.yaml和主入口文件（如myappmain.go）都放在这里。当你部署或运行应用时，通常会指向这个目录。
- /myproject/src/items: 这是一个独立的Go包，其中包含与商品相关的结构体和函数。
- /myproject/src/router: 这是一个独立的Go包，其中包含与路由处理相关的逻辑。
3. 包的导入与引用
在上述结构下，Go编译器能够通过GOPATH找到src目录下的所有包。当你需要在一个包中引用另一个自定义包时，只需使用其在src目录下的相对路径作为导入路径。
示例：items.go 包
假设 items.go 定义了一个 Item 结构体：
// 文件路径: /myproject/src/items/items.go
package items
type Item struct {
Id int
Name string
Price float32
}
// 可以在这里添加其他与Item相关的函数示例：router.go 导入 items 包
现在，在 router.go 中，你可以通过 import "items" 来导入 items 包。Go工具链会在 GOPATH/src 下查找名为 items 的目录。
// 文件路径: /myproject/src/router/router.go
package router
import (
"net/http"
"items" // 正确导入位于GOPATH/src/items的包
)
// ItemsHandler 示例处理函数
func ItemsHandler(writer http.ResponseWriter, request *http.Request) {
anItem := items.Item{Id: 245, Name: "Chocolate", Price: 1.50}
// ... 处理 anItem ...
writer.Write([]byte("Item created: " + anItem.Name))
}
// 可以在这里添加其他路由和处理函数示例：myappmain.go 使用 router 包
你的主应用程序文件 myappmain.go 可以导入并使用 router 包来设置HTTP路由。
// 文件路径: /myproject/src/MyApp/myappmain.go
package myappmain
import (
"net/http"
"google.golang.org/appengine"
"router" // 导入位于GOPATH/src/router的包
)
func init() {
http.HandleFunc("/items", router.ItemsHandler)
// 注册其他路由
}
func main() {
appengine.Main()
}4. 运行 Go App Engine 应用
在本地开发环境中运行App Engine应用时，你需要使用 dev_appserver.py 命令，并将其指向你的应用目录（即包含 app.yaml 的目录）。
示例命令：
# 确保你的当前工作目录在 /myproject 下，或者GOPATH已正确设置 # 然后运行： dev_appserver.py ./src/MyApp
这条命令会启动本地开发服务器，并加载 /myproject/src/MyApp 目录下的App Engine应用。服务器会自动处理所有依赖的包，包括 items 和 router。
总结与注意事项
- GOPATH 是基石：始终确保你的Go App Engine项目位于正确配置的GOPATH下的src目录中。这是Go工具链查找和解析包的根本。
- 清晰的包路径：当导入自定义包时，使用相对于GOPATH/src的路径。例如，如果你的包在GOPATH/src/myproject/mypackage，则导入路径是"myproject/mypackage"。在我们的示例中，items和router直接位于src下，所以导入路径就是"items"和"router"。
- App Engine 应用目录：dev_appserver.py 命令的参数应是包含app.yaml的应用根目录，而不是GOPATH或src目录。
- 验证包加载：如果你对包的加载顺序或是否正确加载有疑问，可以在每个包的 init() 函数中添加 log.Println("<pkg_name> init called") 来进行验证。正确的结构会确保每个包的 init() 函数只被调用一次。
遵循这些最佳实践，你将能够构建结构清晰、易于维护且能顺利编译和部署的Go App Engine应用程序。
