go 1.16+ 默认启用 go modules，无需配置 gopath；关键是要确保 go111module=on、go mod init 的模块路径与 import 路径严格一致，并在项目根目录执行命令。
Go 1.16 之后已默认启用 go modules，GOPATH 不再是硬性要求；但若你用旧教程照搬配置，反而容易触发 cannot find module providing package 或 no required module provides package 这类错误——根源常不在 Go 本身，而在模块模式与工作区路径的错配。
go version 能跑，但 go run 报 no required module 的原因
这是当前最典型的“看似装好了却跑不动”的现象。根本原因是：你没在模块根目录下执行命令，或项目缺少 go.mod 文件。
- 运行
go run main.go前，必须先在该文件所在目录执行go mod init example.com/myapp（模块名可任意，但不能是main） - 如果
main.go在D:\projects\hello，就 cd 进去再 init，别在桌面或C:\根目录操作 -
go mod init生成的go.mod必须和main.go在同一级目录，否则 Go 工具链无法识别模块边界 - Windows 下路径含中文或空格（如
C:\Users\张三\go\src\test）也常触发解析失败，建议用纯英文路径
GOROOT 和 GOPATH 现在还要手动设吗
绝大多数情况不用——尤其是你用的是 Go 1.16+ 且只做新项目开发。
-
GOROOT：安装程序（.msi/.pkg）会自动写入，手动设置反而可能冲突；可通过go env GOROOT确认值，正常应为C:\Go（Win）或/usr/local/go（macOS/Linux） -
GOPATH：仅影响go get（旧模式）或某些遗留工具行为；go modules下依赖默认存放在$GOPATH/pkg/mod，但你完全不需要碰它——go mod download会自动管理 - 真正需要关注的是
GOMODCACHE：如果 C 盘空间紧张，可用go env -w GOMODCACHE=D:\go_modcache搬走缓存，避免爆满
vscode-go 插件报 “GOPATH not set” 怎么办
这不是 Go 的问题，而是插件老版本对模块模式适配不全导致的误报。VS Code 的 Go 扩展（v0.40+）已默认兼容模块，但部分用户仍卡在旧配置。
- 打开 VS Code 设置（
Cmd+,或Ctrl+,），搜索go.gopath，**清空该字段**（留空即可） - 同时检查
go.toolsEnvVars，确保没硬编码GOPATH；如有，删掉整条 - 重启 VS Code 后，在项目根目录（含
go.mod）打开文件夹，左下角状态栏应显示 “Go (module)” 而非 “Go (GOPATH)” - 若仍提示，执行
Go: Install/Update Tools命令（Cmd+Shift+P），全选并安装，尤其确认gopls版本 ≥ v0.15
go proxy 设置不当引发超时或 403
国内直接连 proxy.golang.org 常失败，但乱设镜像也可能引入签名验证问题。
- 推荐组合：
go env -w GOPROXY=https://proxy.golang.org,direct（国际线路）或go env -w GOPROXY=https://goproxy.cn,direct（国内稳定） - 务必保留
,direct后缀——它表示对私有仓库（如公司内网 Git）跳过代理，否则内部模块拉不到 - 若用企业私有 proxy（如 Nexus），需额外设
GOINSECURE=your-internal-domain.com，否则 TLS 验证失败 - 验证是否生效：运行
go env GOPROXY，输出应为完整字符串，不是off或空
模块路径、缓存位置、代理策略这三项一旦设错，错误往往延迟到 go get 或 go build 阶段才暴露，且报错信息高度相似——所以别等出错再查，初始化项目前先跑一遍 go env 看关键变量是否合理。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
