Go 1.11+ 必须用模块名+子路径导入本地包，如 module myapp 则需 import "myapp/utils"，禁止用 "./utils" 或 "utils"；路径必须匹配 go.mod 声明，且 IDE 需以含 go.mod 的目录为工作区根。
Go 1.11 之后，go mod 已成默认包管理方式，本地包导入不再强依赖 GOPATH；但如果你在旧项目或某些 IDE 场景下仍遇到 cannot find package 错误，问题大概率出在模块路径、工作区结构或 import 路径写法不一致上。
go mod init 后 import 本地包仍报错
这是最常见也最容易被忽略的场景：你执行了 go mod init myapp，目录结构是：
myapp/
├── go.mod
├── main.go
└── utils/
└── helper.go
但在 main.go 中写了 import "utils"，Go 就会报错——因为 go mod 下的 import 路径必须是「模块名 + 子路径」，不是文件系统相对路径。
-
go.mod第一行是module myapp，那么utils/包的合法 import 路径就是"myapp/utils" - 如果
utils/helper.go里声明的是package utils，那没问题；但如果它写成了package myutils，则import "myapp/utils"会编译失败（包名和 import 路径无关，但实际引用时用的是包名） - 不要手动改
go.mod里的 module 名来“匹配” import —— 应该让 import 路径匹配module声明
GOPATH/src 下放代码却 still can't find package
这种错误通常出现在启用了 GO111MODULE=on（默认开启）但又没走 go mod 的混合环境里。Go 不再从 $GOPATH/src 自动解析 import，除非你显式关闭模块模式或把项目放在 $GOPATH/src 并用 go install 安装。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 检查是否意外设置了
GO111MODULE=off：运行go env GO111MODULE，输出应为on（现代 Go 默认值） - 若坚持用
GOPATH方式，必须确保：项目路径是$GOPATH/src/your/project，且import语句写的是完整路径，如"your/project/utils" -
go build必须在项目根目录（含go.mod或$GOPATH/src/xxx下）执行，不能在子目录随便跑
vscode 或 goland 提示找不到本地包但命令行能编译
IDE 缓存或 Go 扩展未识别当前模块根目录是主因。VS Code 的 Go 扩展依赖 gopls，而 gopls 需要明确知道 workspace root 是哪个模块。
- 打开项目时，确保 VS Code 是以
myapp/（含go.mod的目录）为根目录打开，而不是它的父目录 - 在 VS Code 中按
Ctrl+Shift+P→ 输入Go: Restart Language Server强制刷新 - 检查设置中
"go.gopath"是否被手动指定——现代项目应留空，让gopls自动推导 - 如果项目有多个
go.mod（比如子模块），确认没有在错误的模块上下文中编辑文件
go run 和 go build 行为不一致导致导入失败
go run 支持单文件运行，但它仍会读取当前目录下的 go.mod 来解析依赖；而如果你在非模块根目录执行 go run utils/helper.go，它会尝试从当前路径向上找 go.mod，找不到就 fallback 到 GOPATH 模式，极易混乱。
- 始终在模块根目录（即含
go.mod的目录）下执行go run main.go - 避免跨目录
go run，例如不要在myapp/下执行go run ../other/pkg/main.go -
go build -o bin/app .和go run .是更安全的写法，它们明确以当前目录为模块上下文
真正容易被忽略的点是：import 路径不是文件路径，也不是 GOPATH 目录名，而是 go mod init 时声明的 module 名 + 目录相对路径；只要这个组合不唯一、不匹配、或 IDE 没加载对模块根，所有“找不到包”的错误都会反复出现。
