本文详解 go 项目中自定义包（如 `app/model`）的正确导入方式，重点说明 gopath 的作用、目录结构规范及 import 路径与文件系统路径的本质区别，帮助开发者避免“cannot find package”等常见错误。

在 Go 中，import "app/model" 并非指向相对路径或当前工作目录下的子文件夹，而是表示从 $GOPATH/src/（或模块根目录）开始查找的全路径导入标识符。你遇到的错误 /usr/local/go/src/pkg/model (from $GOROOT) 正是 Go 编译器误将 app/model 解析为标准库路径（因 $GOROOT/src/pkg/ 存在类似结构），根源在于包未置于合法的导入上下文中。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

✅ 正确做法（Go 1.11+ 推荐模块化方案）：

1. 在项目根目录（如 app/）初始化 Go 模块：

   cd app
   go mod init example.com/app

2. 确保目录结构为：

   app/
   ├── go.mod          # 由 go mod init 生成
   ├── main.go
   └── model/
    ├── file1.go
    └── file2.go

3. 在 main.go 中导入：

   package main

import ( "fmt" "example.com/app/model" // ✅ 模块路径 + 子目录 )

func main() { fmt.Println(model.SomeFunc()) // 假设 model 定义了导出函数 }

⚠️ 注意事项：  
- `import "app/model"` **永远无效**——Go 不支持基于当前目录的短路径导入；  
- 若未启用模块（即无 `go.mod`），必须严格遵循 `$GOPATH/src/` 结构，例如将项目放在 `$GOPATH/src/example.com/app/`，再用 `import "example.com/app/model"`；  
- 所有被导入的 `.go` 文件需声明相同 `package model`（非 `package main`），且首字母大写的标识符才可被外部访问；  
- 运行 `go build` 或 `go run main.go` 时，务必在包含 `go.mod` 的目录下执行，否则模块解析失败。

? 总结：Go 的 import 路径 = 模块名 + 相对子路径（模块模式）或 `$GOPATH/src/` 下的完整路径（GOPATH 模式）。放弃“类 Python 相对导入”思维，拥抱显式、唯一、可复现的模块路径设计，是解决导入问题的根本之道。