go mod init 报错“no module found”说明模块模式未启用或路径非法；必须执行 go env -w go111module=on 强制开启，并在非 gopath/src 的空目录下运行 go mod init。
go version 能跑，但 go mod init 报错：no module found
说明 Go SDK 已安装成功，但模块模式没启用或当前目录不在合法项目路径下。Go 1.16+ 默认启用模块，但某些旧系统或手动配置可能仍关闭 GO111MODULE。
- 执行
go env -w GO111MODULE=on强制开启模块支持（必须加-w才写入环境） - 不要在
%GOPATH%\src下初始化模块——这是旧式 GOPATH 模式路径，go mod init在这里会拒绝创建（报错 “cannot determine module path”） - 新建空目录，比如
D:\myproject，cd 进去再运行go mod init example.com/myproject - 如果提示
go: cannot find main module，说明当前没在模块根目录，或go.mod文件缺失——直接补一个go mod init即可，不用删文件重来
Windows 上 GOPATH 和 GOROOT 必须手动配吗？
Windows 安装 .msi 包时，GOROOT 通常自动写入（指向 C:\Program Files\Go），但 GOPATH 不会自动设——它默认 fallback 到 %USERPROFILE%\go，但这个路径可能没被创建，导致 go install 失败或工具找不到 bin。
- 建议显式设置
GOPATH，比如D:\go_workspace，并手动创建该目录 - 把
%GOROOT%\bin和%GOPATH%\bin都加进系统PATH——缺后者会导致gopls、dlv等工具命令不可用 -
go env输出里看GOPATH值是否是你期望的路径；如果不是，用go env -w GOPATH=D:\go_workspace覆盖 - 注意：
GOROOT一般不动，除非你装了多个 Go 版本并用gvm切换
VS Code 里写 Go 代码，提示“command 'go.gopath' not found”
这是 Go 插件（Go by Google）没识别到 Go 环境，或插件本身未正确激活。不是 PATH 没配好，就是插件配置冲突。
- 先确认 VS Code 终端里能运行
go version和go env——如果不能，说明终端没继承系统 PATH，需重启 VS Code - 卸载重装 Go 插件：禁用 → 重启 VS Code → 重新安装 → 弹出“Install tools?”时点“Yes”（它会自动装
gopls、dlv等） - 检查 VS Code 设置里的
"go.goroot"是否为空；如果手动填了错误路径（比如指向C:\Go\但实际装在C:\Program Files\Go），删掉这行让插件自动探测 - 若用 WSL，确保 VS Code 是从 WSL 启动（用
code .），而不是 Windows 版本连 WSL，否则 Go 插件会按 Windows 路径找二进制
国内依赖下载慢或超时，GOPROXY 设了还是失败
常见原因是代理地址格式不对、网络策略拦截，或用了已停服的镜像源（如 https://goproxy.io 自 2023 年起已停止服务）。
- 推荐组合：
go env -w GOPROXY=https://goproxy.cn,direct或https://proxy.golang.org,direct（后者需科学上网） - 如果公司内网屏蔽外部代理，可设为
off并用私有 proxy（如 Nexus + Go plugin），但必须配go env -w GOPROXY=off，不能留空 - 执行
go get -v github.com/gorilla/mux测试，观察输出里是否出现Fetching https://goproxy.cn/...——没出现说明没生效 - 某些杀毒软件（如 360、火绒）会劫持 HTTPS 请求，临时禁用它们再试
GO111MODULE 开关状态、GOPATH\bin 是否在 PATH、以及 VS Code 插件是否真正拉取了 gopls ——这三个点不验证清楚，后面所有编辑、调试、测试都会断链。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
