本文讲解 go 项目中本地包的命名、目录结构与导入路径规则，重点解决因 gopath、模块路径或未使用导入导致的“包无法引用”问题，并提供可立即验证的实践方案。
本文讲解 go 项目中本地包的命名、目录结构与导入路径规则，重点解决因 gopath、模块路径或未使用导入导致的“包无法引用”问题，并提供可立即验证的实践方案。
在 Go 中，“包名”（package sbp）和“导入路径”（import path）是两个不同概念：前者是源文件内声明的逻辑包标识（用于作用域和类型解析），后者是 import 语句中指定的唯一字符串路径（由模块根目录 + 相对子路径构成）。你当前的结构：
/sbp
/models.go
/controllers.go ← 注意：文件名应为 controller.go（原问题中为 controllers.go，但示例代码写为 controller.go，此处按后者统一）
/main.go
存在两个关键前提缺失：
-
未初始化 Go 模块：Go 1.11+ 推荐使用
go mod管理依赖和导入路径。若项目根目录（即main.go所在目录）未运行go mod init <module-name></module-name>，Go 将无法解析本地包路径； -
导入路径不匹配实际模块结构：
import "sbp/controller"是无效的——Go 不支持以/分隔的相对路径导入本地包；必须使用完整模块路径 + 子目录。
✅ 正确做法如下：
1. 初始化模块并确认模块路径
在项目根目录（含 main.go）执行：
go mod init github.com/jiewmeng/finance
这将生成 go.mod 文件，声明模块名为 github.com/jiewmeng/finance。此后，所有本地包的导入路径均以此为前缀。
2. 规范目录与包结构
确保 sbp/ 目录下有 controller.go（注意单数形式，且首字母小写更符合 Go 惯例），其包声明为：
// sbp/controller.go
package sbp
import (
"net/http"
"github.com/pressly/chi/render"
)
func AddInvestment(w http.ResponseWriter, r *http.Request) {
// 实现逻辑
}
func GetInvestments(w http.ResponseWriter, r *http.Request) {
// 实现逻辑
}
⚠️ 注意：
package sbp表示该文件属于sbp包，但它的导入路径是github.com/jiewmeng/finance/sbp，而非sbp或sbp/controller。
3. 在 main.go 中正确导入并使用
// main.go
package main
import (
"net/http"
"github.com/pressly/chi"
// ✅ 正确导入路径：模块名 + 子目录
"github.com/jiewmeng/finance/sbp" // ← 导入整个 sbp 包
)
var sess = session.Must(session.NewSession(&aws.Config{
Region: aws.String("ap-southeast-1"),
}))
var dynamo = dynamodb.New(sess)
func main() {
r := chi.NewRouter()
// ✅ 使用包名 sbp 限定函数（因导入的是 github.com/jiewmeng/finance/sbp，包名为 sbp）
r.Get("/", sbp.GetInvestments)
r.Post("/", sbp.AddInvestment)
http.ListenAndServe(":8080", r)
}
4. 为什么 VS Code 自动删除导入？
你的编辑器（如 VS Code 配合 gopls 或 goimports）会自动清理未被使用的导入。仅写 import "github.com/jiewmeng/finance/sbp" 而不调用 sbp.GetInvestments，该行将被移除。务必确保导入后实际使用包内符号。
补充建议
- ✅ 包名应简洁、小写、无下划线（如
sbp合规，sbp_controller不推荐）； - ✅ 避免在
main包外定义main函数，sbp包中不应含func main()； - ✅ 若需拆分
controller和model，可建sbp/controller/和sbp/model/子目录，各自package controller/package model，导入路径则为github.com/jiewmeng/finance/sbp/controller； - ? 验证导入是否生效：运行
go list -f '{{.Dir}}' github.com/jiewmeng/finance/sbp，应输出sbp目录绝对路径。
遵循以上步骤，即可稳定、清晰地组织多包 Go 项目，并彻底解决“包找不到”或“导入被清除”的常见问题。
