如何在 Go 项目中正确导入本地自定义包

在 go 中，可通过完整模块路径（如 `github.com/myusername/myfirstrepo/somefolder1/package1`）直接导入同一 `$gopath` 下的本地自定义包，无需发布到 github 或使用相对路径；相对导入（如 `./../…`）不被 go 工具链支持。

Go 的包导入机制严格依赖导入路径（import path），而非文件系统相对位置。这意味着你不能像 node.js 中使用 import “./../somefolder1/package1” 那样通过相对路径引用包——Go 编译器会直接报错：local import “./…” not allowed in non-local import configuration。

✅ 正确做法是：使用符合 Go 工作区规范的绝对导入路径。假设你的项目位于 $GOPATH/src/github.com/myusername/myfirstrepo/，且结构如下：

$GOPATH/src/github.com/myusername/myfirstrepo/ ├── somefolder1/ │   └── package1/ │       ├── package1.go │       └── go.mod (可选，若为 module-aware 模式) └── somefolder2/     └── package2/         └── main.go

那么在 somefolder2/package2/main.go 中，应这样导入 package1：

package main  import (     "fmt"     "github.com/myusername/myfirstrepo/somefolder1/package1" // ✅ 正确：基于 GOPATH 的完整路径 )  func main() {     result := package1.DoSomething()     fmt.Println(result) }

⚠️ 注意事项：

• 确保 $GOPATH 已正确设置（可通过 go env GOPATH 验证），且项目确实位于 $GOPATH/src/ 下对应路径；
• 若使用 Go Modules（Go 1.11+ 默认推荐），建议在项目根目录（myfirstrepo/）运行 go mod init github.com/myusername/myfirstrepo 初始化模块，此时导入路径仍保持一致，但工具链将基于 go.mod 解析依赖；
• 不要创建 go.mod 文件后又试图用相对路径导入——Go Modules 模式下同样禁止 ./ 导入，且会优先从模块路径解析；
• 相对导入仅在极少数特殊场景（如 go run . 临时测试单文件）中被允许，绝不适用于跨包复用。

? 小结：Go 的设计哲学强调可重现性与明确性——每个导入路径都应唯一标识一个可复现的包源。因此，请始终使用语义清晰、基于代码仓库结构的绝对路径（如 github.com/user/repo/subdir/pkgname），这既是最佳实践，也是 Go 工具链的强制约定。