Go禁止使用./或../导入本地包，仅支持模块路径（如"myapp/utils"）或完整远程路径（如"github.com/you/project/utils"）；跨目录引用需用replace指令，IDE报错常因gopls未正确识别go.mod根目录。
Go不支持./utils这种写法，不是配置问题，是语言设计硬限制
你写的import "./utils"或import "../shared"会直接报错：local import "./utils" in non-local package。这不是IDE没刷新、GOPATH没设对，也不是go.mod漏了什么——Go编译器从1.0开始就禁止解析以./或../开头的导入路径。它要的是逻辑路径（import path），不是文件系统路径。
真正有效的本地包引用只有两种合法形态：
- 模块路径：如
import "myapp/utils"（前提是go.mod第一行是module myapp，且utils/在项目根目录下） - 完整远程路径：如
import "github.com/you/project/utils"（即使本地开发，也得用这个格式）
go mod init后仍cannot find package？检查这三处
执行了go mod init myapp，目录结构也对，但main.go里写import "myapp/utils"还是失败，大概率卡在这三点：
-
go.mod所在目录不是当前工作区根目录：你在/home/user/myapp下执行了go mod init，但VS Code打开的是/home/user父目录——gopls找不到go.mod，就当普通文件处理 -
utils/helper.go开头没写package utils：包声明必须和目录名一致，不能是package helpers或package main - 执行
go build不在项目根目录：你在myapp/utils子目录下跑go build，Go不会向上找go.mod，直接报错
跨目录本地模块怎么引用？用replace，别碰require
主项目在~/proj，想引用隔壁~/lib/utils（它自己也有go.mod），不能靠改import路径硬凑，必须走replace：
- 先确认
~/lib/utils/go.mod第一行是module github.com/you/utils - 在
~/proj/go.mod末尾加一行：replace github.com/you/utils => ../lib/utils - 运行
go mod tidy——它会验证../lib/utils下有合法go.mod并生成伪版本 - 代码里照常写
import "github.com/you/utils"，不用改
注意：replace只影响构建，不改变导入路径本身；CI环境没有../lib/utils路径，所以发布前必须删掉这行。
IDE提示“找不到包”但命令行能编译？重置gopls工作区
VS Code或Goland报红，但终端go run main.go完全正常，说明是gopls没识别到模块根。操作顺序不能错：
- 关掉所有编辑器窗口
- 用文件管理器直接双击打开
myapp/这个含go.mod的文件夹（不是它的父目录） - VS Code里按
Ctrl+Shift+P→ 输入Go: Restart Language Server - 检查设置里
go.gopath是否为空——现代项目不该手动填这个
最常被忽略的是：项目里存在多个go.mod（比如myapp/sub/go.mod），gopls可能误判当前编辑的文件属于子模块，导致导入路径解析错乱。
