迁移后ide无法识别go环境，90%因goroot指向旧路径或含空格/中文；必须设为含src/pkg/bin的根目录（如/usr/local/go或d:\go），改后须重启ide；gopls需go install并确保gobin在path中，代理和go111module须与终端一致。
迁移后 IDE 无法识别 Go 环境，90% 是因为 GOROOT 指向了旧安装路径，或新路径含空格/中文导致静默失败——IDE 不会报错，只会让 fmt 标红、运行按钮变灰、gopls 启动失败。
GOROOT 必须指向真实安装根目录，不是 bin 子目录
填错 GOROOT 是最常见原因。它必须是包含 src、pkg、bin 三文件夹的顶层路径，比如 /usr/local/go（macOS/Linux）或 D:\Go（Windows），绝不能是 /usr/local/go/bin 或 C:\Go\bin。
- 验证方式：终端执行
go env GOROOT，复制输出值，直接粘贴进 GoLand 的Settings → Go → GOROOT - Windows 用户特别注意：
C:\Program Files\Go因空格必然失败；必须卸载重装到D:\Go这类扁平路径 - macOS 用 Homebrew 安装的，
GOROOT通常是/usr/local/opt/go/libexec，不是/usr/local/bin/go - 改完必须关闭并重启 GoLand——点 “Apply” 不生效，GUI 进程不重读配置
GOBIN 和 gopls 路径不一致导致补全失效
gopls 是 GoLand 补全、跳转、诊断的核心，但它不是 Go 自带，也不随 IDE 自动安装。如果终端能跑 gopls version，但 IDE 里 fmt 无法跳转，说明 IDE 没找到它。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 先在终端运行
go install golang.org/x/tools/gopls@latest，再执行gopls version确认输出正常 - 运行
go env GOBIN，把该路径加进系统PATH（Windows 是系统环境变量，macOS/Linux 是~/.zshrc） - GoLand 设置里不用手动填
gopls路径，只要它能在终端直接执行，IDE 就会自动发现 - 不要在 GoLand 里设置
go.toolsGopath——这是过时配置，反而干扰gopls扫描
模块感知断连：go.mod 存在但 import 仍标红
迁移后项目结构没变，但 IDE 突然不认 go.mod，本质是工作区未被识别为 module 根，和代码本身无关。
- 检查项目根目录下是否有
go.mod文件，且不能被同级的go.work覆盖（有就删掉） - GoLand 必须用 “Open Folder” 方式打开整个项目根目录，不能只双击
main.go—— 后者会让 IDE 当作单文件处理 - 右下角状态栏应显示
gopls (running)和你的模块名（如example.com/myapp），否则就是没认对 - 命令行快速验证：在项目根目录下执行
go list ./，能输出command-line-arguments才算 module 加载成功 - 若已打开但无效，右键项目根目录 →
Reload project，不是点 “Sync” 或重启 IDE
代理与模块模式未同步触发依赖加载失败
迁移后 go mod tidy 在终端成功，但 GoLand 里右键 “Download dependencies” 卡住或报 cannot find module providing package，问题出在代理和模块开关没对齐。
- 终端执行
go env -w GOPROXY=https://goproxy.cn,direct（国内）或go env -w GOPROXY=https://proxy.golang.org,direct（海外），direct不能省，否则私有模块拉不到 - 确认
GO111MODULE是on：运行go env GO111MODULE，不是auto或off；若不对，执行go env -w GO111MODULE=on - GoLand 设置中勾选
Enable Go modules integration，Proxy 字段填和终端一致的地址 - 改完代理后必须重启 GoLand，否则 IDE 缓存旧配置，CLI 和 IDE 实际用的是两套代理
最容易被忽略的是：迁移后你可能保留了旧的 GOPATH 环境变量或 GoLand 里残留的 GOPATH 设置，这会干扰模块路径推导——建议清空 Settings → Go → GOPATH 中的内容，让 IDE 完全走 module 模式。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
