Go开发环境迁移需正确配置GOROOT、GO111MODULE、go.mod位置及IDE工具链路径；GOROOT须手动指定新路径，GO111MODULE=on为默认但需确保项目根目录含正确模块名的go.mod，IDE设置如GOROOT/GOPROXY/Shell路径需人工重设，replace依赖须用相对路径并验证生效。
Go 开发环境迁移不是换个目录或重装 IDE 就能跑起来的事——GOROOT、GO111MODULE、go.mod 位置、IDE 工具链路径这四点一错，go build 直接报 cannot find module providing package 或 import path does not begin with hostname。
GOROOT 和 GOPATH 不再决定项目位置，但必须显式配置
Go 1.11+ 默认启用 modules，go 命令只认当前目录是否有 go.mod，完全忽略 $GOPATH/src 的物理结构。但 IDE（如 GoLand）仍需你手动指定 GOROOT 路径，否则无法解析标准库、无法跳转、无法补全。
- 旧环境的
GOROOT=C:\Program Files\Go在新机上大概率不存在，必须进Settings → Go → GOROOT点 + 号重新添加 -
GO111MODULE=on是现代 Go 默认值，但若旧项目没go.mod，又在$GOPATH/src下执行go run，会因自动 fallback 到 GOPATH 模式而失败 -
GOPATH现在只用于存放$GOPATH/pkg/mod（依赖缓存）和$GOPATH/bin（go install产出），不建议再把它当“项目根目录”用
go.mod 必须在项目根目录，且模块名不能随便写
迁移时最容易犯的错：把老项目整个拷过去，直接在子目录里 go mod init，结果模块名写成 main 或 project，导致所有 import 路径失效。
- 运行
go mod init前，cd 进项目真正的根目录（即包含所有.go文件和历史import路径的顶层目录） - 模块名建议用实际远程路径，比如原项目 import 是
"github.com/user/repo/utils"，就该写go mod init github.com/user/repo - 如果只是本地实验项目，模块名可自定义（如
myapp），但后续所有import都得按这个前缀来，不能混用旧 GOPATH 风格路径 - 执行
go mod tidy后检查go list -m all输出，确认私有仓库（如 GitLab 内网地址）是否被正确拉取；若失败，可能需要配GOINSECURE或git config --global url."https://gitlab.example.com/".insteadOf "git@gitlab.example.com:"
GoLand 迁移设置必须人工重设三项关键路径
导出 settings.zip 只能同步快捷键、主题、插件列表，GOROOT、GOPROXY、终端 Shell path 这三项是硬编码绝对路径，导入后必然失效。
立即学习“go语言免费学习笔记（深入）”；
- 导入必须在新机首次启动 GoLand 时完成（Welcome 页面 → Configure → Import Settings），之后再导入无效
-
GOROOT：指向新机 Go 安装目录，Windows 常见路径是C:\Program Files\Go，macOS 是/usr/local/go，Linux 多为/home/username/go -
GOPROXY：国内务必设为https://goproxy.cn,direct，旧配置残留的https://proxy.golang.org会导致go get卡死或超时 - 终端 Shell：若旧机用 WSL2，新机改用原生 Windows，则
Shell path必须从wsl.exe改成powershell.exe，否则go run在终端里执行失败
本地 replace 依赖不能靠路径猜测，要验证实际生效
老项目常依赖 $GOPATH/src 下修改过的本地 fork 包，迁移到 modules 后，必须用 replace 显式覆盖，否则 go mod tidy 仍会拉远端 tag 版本。
- 在
go.mod末尾加replace github.com/old/lib => ../local-lib，路径必须是相对于go.mod所在目录的相对路径 - 加完后立刻运行
go mod graph | grep old/lib，确认输出中显示的是../local-lib而非远端版本号 - 改完
go.mod后别忘了go mod vendor（如需 vendor）或至少go build一次，IDE 缓存可能不会自动刷新 - 如果
../local-lib本身也有go.mod，确保它的module名与replace左侧完全一致，大小写都不能错
真正卡住人的往往不是命令记不住，而是 go.mod 放错了位置、replace 路径算错了层级、或者 GoLand 里 GOROOT 还指着已删除的旧路径——这些地方不报错，但编译和运行就是不走预期逻辑。
