Go 项目中正确导入本地包的方法，主要涉及 Go 模块（Go Modules）的使用。以下是一个详细的步骤指南，帮助你正确导入和管理本地包。一、使用 Go Modules（推荐）从 Go 1.11 开始，Go 引入了 Go Modules，这是目前最推荐的依赖管理方式，它支持本地包的导入。1. 初始化模块在你的项目根目录下运行：go mod init your-module-name例如：go m

在 Go 项目中正确导入本地包的关键在于摒弃相对路径（如 `./common`）的错误做法，严格采用基于模块名或项目根路径的绝对导入路径（如 `"myproject/mypackage"`），并依托 Go Modules（推荐方式）进行依赖管理——只需在项目根目录执行 `go mod init your-module-name` 初始化模块，确保本地包位于模块根目录下且拥有合法 `package` 声明，Go 工具链即可自动解析路径；这一机制不仅规避了传统 GOPATH 模式的限制，更保障了构建的可重现性与跨环境一致性，是每个 Go 开发者必须掌握的基础实践。

Go 要求所有包导入路径必须是绝对路径（相对于 GOPATH/src 或 Go Modules 根目录），不支持相对路径（如 `./common`）；本地包应使用以模块名或项目路径开头的完整导入路径，例如 `"myapp/common"`。

在 Go 中，导入本地包是一个初学者常遇到的误区。错误地使用相对路径（如 "./common"）会导致编译失败，并提示 local import "./common" in non-local package —— 这是因为 Go 语言规范明确禁止在非命令行主包（即非 package main 的独立可执行包）中使用相对导入路径，且所有导入路径必须是“完整、可解析的导入路径”。

✅ 正确做法是：将本地包置于 $GOPATH/src/（旧式 GOPATH 模式）或模块根目录下（Go Modules 模式），并使用基于工作区路径的绝对导入路径。

假设你的项目结构如下（使用传统 GOPATH 模式）：

/home/me/go/src/myapp/
├── main.go
├── common/
│   └── common.go
└── routers/
    └── router.go

那么 main.go 中应这样导入：

import (
    "log"
    "net/http"
    "myapp/common"   // ✅ 正确：以 myapp/ 开头，对应 $GOPATH/src/myapp/common
    "myapp/routers" // ✅ 正确：同理
)

⚠️ 注意事项：

• 不要写 ./common 或 ../common —— Go 不支持相对导入（除极少数测试场景外，且仍受限）；
• 不要省略前缀直接写 "common" —— Go 会去 $GOROOT/src 和 $GOPATH/src 的顶层查找，而非子目录；
• 若使用 Go Modules（推荐），请先在项目根目录运行 go mod init myapp，确保 go.mod 文件存在，此时导入路径仍为 "myapp/common"（模块名作为根路径），Go 工具链会自动解析；
• 包名（package common）与导入路径末段（myapp/common 中的 common）可以不同，但通常保持一致以提升可读性；
• 所有本地包目录内必须包含有效的 package xxx 声明，且不能与 main 包同名。

? 小技巧：可通过 go list -f '{{.Dir}}' myapp/common 验证 Go 是否能正确定位包路径。若报错，说明路径未被识别，需检查目录结构或模块初始化状态。

总结：Go 的导入机制强调可重现性与可移植性，因此强制使用绝对路径。只要确保项目位于 $GOPATH/src/ 下（或已启用 Go Modules 并配置好模块路径），并采用 / 形式导入，即可无缝使用本地包。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Go 项目中正确导入本地包的方法，主要涉及 Go 模块（Go Modules）的使用。以下是一个详细的步骤指南，帮助你正确导入和管理本地包。一、使用 Go Modules（推荐）从 Go 1.11 开始，Go 引入了 Go Modules，这是目前最推荐的依赖管理方式，它支持本地包的导入。1. 初始化模块在你的项目根目录下运行：go mod init your-module-name例如：go mod init myproject这会创建一个 go.mod 文件，用于记录项目依赖。2. 创建本地包假设你有一个本地包，结构如下：myproject/ ├── go.mod ├── main.go └── mypackage/ ├── package.go └── go.sum在 main.go 中导入本地包：package main import ( "myproject/mypackage" ) func main() { mypackage.MyFunction() }注意：这里的路径是相对于 go.mod 文件的相对路径。3. 确保 GOPATH 设置正确确保你的 GOPATH 设置正确，或者使用 GO111MODULE=on 来强制启用模块模式。export GO111MODULE=on》文章吧，也可关注golang学习网公众号了解相关技术文章。