go包导入失败90%源于路径或位置错误：import必须紧贴package声明，中间不能有空行或普通注释；启用module后禁止./相对路径，须用模块路径如"example.com/myapp/utils"；_导入仅执行init()，不引入符号；点导入易冲突，推荐别名导入。
Go 包导入失败，90% 是路径写错或位置放错，不是环境或网络问题。
import 必须紧贴 package 声明，中间不能有空行或普通注释
Go 编译器把 import 当作编译期硬性解析指令，不是语法糖。它只认一种合法结构：package main 后**立刻**跟 import，中间不能插任何东西。
- 错误写法：
package main→ 空行 →// config→import "fmt"→ 报错import statement not allowed here - 唯一允许的例外是文档注释：
// Package main（以// Package开头的单行注释）可放在package和import之间 - 多行
import必须用括号，每个路径独立成行并用双引号包裹：import ( "fmt" "os" )，写成import ( fmt os )直接报错
启用 Go Modules 后，禁止使用 ./ 或 ../ 相对路径导入
只要项目根目录存在 go.mod，Go 就强制进入 module 模式，此时 import "./utils" 是语法错误，不是风格问题。
- 正确做法：确保本地包在模块路径下。例如
go mod init example.com/myapp后，./utils/目录下的包必须通过import "example.com/myapp/utils"导入 - 想引用兄弟目录（如
../shared）？不能直接写路径，得用go mod edit -replace shared=../shared显式映射，再go mod tidy - 验证是否生效：运行
go list -f '{{.Dir}}' example.com/myapp/utils，输出应为实际磁盘路径；若报错或为空，说明路径未被识别
空白导入（import _ "xxx"）只触发 init()，不提供任何符号
import _ "net/http/pprof" 这类写法不是“懒加载”，而是纯粹为了副作用——执行目标包里的 init() 函数。
- 典型用途：数据库驱动注册，如
import _ "github.com/go-sql-driver/mysql"，让sql.Open("mysql", ...)可用 - 误用后果：
import _ "fmt"后，fmt.Println依然不可用，且会触发imported and not used错误 - 关键判断点：你得确认该包确实实现了
func init()并做了显式注册（比如调用了pprof.Register或sql.Register），否则这行导入毫无意义
别名导入比点导入安全，命名冲突时必须用别名
import . "math" 会把 math 里所有导出名直接塞进当前命名空间，极易引发冲突，几乎不该用；而别名是可控、明确的替代方案。
- 解决同名类型冲突：两个包都导出
Server，就写import http "net/http"和import fasthttp "github.com/valyala/fasthttp" - 缩写长路径：如
grpc "google.golang.org/grpc"，比反复写全称清晰得多 - 避免与局部变量名冲突：比如你有个变量叫
log，那就别import "log"，改用l "log"或直接用别名隔离
真正卡住人的从来不是语法有多难，而是 go.mod 路径声明和实际目录结构不一致、import 位置多了一行空格、或者以为 _ 导入能“顺便”拿到函数——这些细节一旦错位，编译器不会给你商量余地。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
