go语言包导入需使用完整路径而非相对路径，基于go.mod定义的模块路径进行绝对导入，标准库直接写包名，第三方或本地包需写全路径，如“example.com/myapp/pkg/log”；可通过别名解决命名冲突或简化调用，如import json2 "encoding/json"；禁止循环导入，避免使用.导入以防混淆，internal包受访问限制；常见错误包括路径错误、循环依赖和未正确调用包名，应确保go.mod配置正确并遵循最佳实践，如按组排序导入、及时清理未使用包。
Go 语言的包导入看似简单，但实际使用中容易因路径、命名、循环依赖等问题出错。核心原则就一条：用 完整导入路径（即模块路径 + 包名），而不是文件系统相对路径。
导入语法与路径规则
Go 不支持类似 python 的相对导入（如 from . import xxx），所有导入都必须是绝对路径，基于 go.mod 定义的模块路径或标准库路径。
- 标准库包：直接写包名，如
import "fmt"、import "net/http" - 第三方或本地模块包：写完整模块路径，如
import "github.com/gin-gonic/gin"或import "myproject/internal/utils" - 本地项目内子包：路径从模块根开始，比如模块是
example.com/myapp，子目录myapp/pkg/log就要写import "example.com/myapp/pkg/log"，不能写import "./pkg/log"
包名重命名（alias）的实用场景
当导入包名冲突，或想简化长包名时，可用点号（.）或自定义别名：
-
import json2 "encoding/json"：避免和另一个json包冲突 -
import . "math"：把math包的导出符号直接引入当前作用域（慎用，降低可读性） -
import _ "database/sql/driver"：仅执行包初始化（如注册驱动），不使用其导出符号
常见错误与排查方法
报错信息往往直指根源，关键看提示关键词：
立即学习“go语言免费学习笔记（深入）”；
-
cannot find package "xxx"：路径拼错、没加go.mod、模块未go get或 GOproxy 配置异常 -
import cycle not allowed：A 导入 B，B 又导入 A —— Go 禁止循环导入，需重构（如抽离公共接口到第三个包） -
undefined: xxx：包导入了但没用对应包名调用，比如import "fmt"后写Println("hi")而不是fmt.Println("hi") - 本地包无法识别：确认
go.mod的module声明与导入路径前缀一致，且子包在模块目录下
最佳实践小贴士
写得清楚、跑得稳定，靠的是习惯：
- 一个文件只导入真正用到的包，不用的及时删掉（
go fmt会自动清理） - 按约定分组排序：标准库 → 第三方 → 本地模块（
go fmt默认支持） - 避免用
.导入，尤其在多人协作项目中，它会让函数来源变得模糊 - 内部包（
internal/下）只能被同一模块的父级或同级包引用，这是 Go 的封装机制，不是 bug
基本上就这些。golang import 不复杂但容易忽略路径本质，盯住 go.mod 和完整路径，90% 的问题就消了一半。