答案是路径冲突导致模块名与实际位置不匹配，需在空目录下用合法module path执行go mod init，删错mod重试，避免中文/空格路径，并确保IDE重载项目及配置GOPROXY。
Go 环境装不起来，八成不是你手速慢，而是 GOROOT 指错了、GO111MODULE 没开、或者 IDE 没 reload —— 这些坑官网不写，但每个新手都踩过。
go version 能跑，但 go mod init 报错：module declares its path as … but was located at …
这是 Go Modules 启用后最典型的路径冲突，本质是项目目录和 go.mod 里声明的模块名不匹配。常见于复制粘贴旧项目、或在桌面/Downloads 目录直接初始化。
- 确保你在**空目录**下执行
go mod init example.com/myapp，不要在已有代码的父级目录操作 - 模块名（如
example.com/myapp）只是逻辑标识，不一定要真实存在，但必须唯一且不含空格、大写字母、下划线 - 如果已生成错误的
go.mod，删掉它再重试；别改里面的内容来“凑合”，Go 会校验路径一致性 - Windows 用户特别注意：路径中含中文或空格（比如
C:\Users\张三\go\hello）会导致解析失败，建议用英文路径
GoLand / VS Code 显示 import 红线、运行按钮灰掉
IDE 没识别到 Go 工具链或模块状态，不是代码问题，是配置断连。
- GoLand：进
Settings → Go → GOROOT，手动选中/usr/local/go（macOS/Linux）或C:\Go（Windows）——必须是根目录，不能选到bin/go - VS Code：确认已安装
Go扩展，并在设置里打开"go.useLanguageServer": true；如果提示"GOPATH not set"，其实可以忽略，现代项目靠go.mod驱动，不用依赖GOPATH - 无论哪个 IDE，改完配置后必须重启或点击
Reload project（不是Sync），否则缓存不会刷新 - 如果
fmt、test等命令仍报错，终端里运行go env -w GOPROXY=https://goproxy.cn,direct，国内网络下没代理，go get基本卡死
go run main.go 成功，但 go build 出来的二进制无法运行
这不是编译失败，而是构建产物依赖动态链接或运行时路径不对，尤其在跨平台或使用 cgo 时明显。
立即学习“go语言免费学习笔记（深入）”；
- 默认
go build生成的是静态链接二进制（无外部依赖），但如果代码里用了net、os/user等包，在某些 Linux 发行版上可能仍需 libc 支持 - 想彻底静态编译：加参数
CGO_ENABLED=0 go build，适用于部署到 Alpine 等精简镜像 - Mac 上构建的二进制不能直接丢到 Linux 服务器跑，Go 默认按当前平台构建；跨平台请用
GOOS=linux GOARCH=amd64 go build - build 后文件权限可能不可执行（尤其 Windows WSL 下），记得
chmod +x ./myapp
真正卡住人的从来不是语法，而是环境变量拼写少个字母、IDE 缓存没清、代理少了个 ,direct。这些点不写进配置，光看文档永远不知道它在哪等你。
