Go语言多项目管理核心是弃用GOPATH，直接使用go mod+独立项目目录；go mod init初始化模块后，必须在含go.mod的根目录执行go run等命令，IDE需打开项目根目录而非单文件。
Go 语言环境搭建和多项目管理，核心就一条：别碰 GOPATH 目录结构，直接用 go mod + 独立项目目录。老式 GOPATH 工作区模式在 Go 1.16+ 已完全退场，硬套只会卡在依赖下载失败、IDE 无法识别包、go run 报错找不到模块。
go version 和 go env 验证时发现 GOROOT 为空或路径错误
这说明系统没找到 Go 安装位置，不是没装，是 PATH 没导对。
-
GOROOT由安装程序自动设置（如 Windows .msi、macOS .pkg），但 Homebrew 或手动解压安装必须手动指定 - Linux/macOS 手动解压后，确认
/usr/local/go/bin（或你解压的实际路径）已加入PATH，且执行which go能返回该路径 - 运行
go env -w GOROOT=/usr/local/go（替换成你的真实路径）可强制写入，避免 IDE（如 GoLand、VSCode）读取失败 - Windows 用户注意：PowerShell 和 CMD 的环境变量不互通，验证务必在同一种终端里完成
go mod init 后 go run main.go 报错：cannot find module providing package
这是最常见误操作：你在非项目根目录下执行了 go run，或者 go.mod 文件不在当前工作目录。
- 确保终端
pwd（macOS/Linux）或cd（Windows）输出的路径，和go.mod所在目录一致 -
go mod init必须在空目录或含.go文件的目录中运行；如果已有go.mod，再执行会覆盖，导致模块路径错乱 - 模块名（如
go mod init myapp）只是逻辑标识，不影响文件位置，但必须全小写、无空格、无大写字母——否则某些工具（如gopls）解析失败 - 如果项目从 Git 克隆而来，先检查是否有
go.mod；没有就补上，别直接go run *.go
多个 Go 项目共存时依赖冲突或调试跳转失效
根本原因不是“多项目”，而是 IDE 或命令行没按模块边界隔离上下文。
立即学习“go语言免费学习笔记（深入）”；
- 每个项目必须有独立的
go.mod，且位于项目根目录；不要把多个go.mod放进同一父目录下（比如全塞进~/go/src） - VSCode 中打开的是「整个文件夹」，不是单个文件——必须用 Finder/Explorer 打开项目根目录，而不是打开
main.go文件本身 - GoLand 默认识别
go.mod，但如果项目嵌套（如project/backend有独立go.mod），需右键该子目录 → “Mark Directory as” → “Sources Root” -
go clean -modcache不解决多项目问题，只清全局缓存；真正要隔离，靠的是每个项目自己的go.sum和go mod download行为
真正容易被忽略的点是：Go 不靠目录约定管理项目，靠的是 go.mod 文件存在与否和所在位置。删掉它，整个项目就退化成一堆裸源文件；挪错位置，IDE 就当它不存在。所有“多项目混乱”，90% 源于人试图用旧思维组织新机制。
