go version报错说明path未生效，非安装失败；windows需检查是否勾选add go to path、goroot是否正确指向c:\go、%goroot%\bin是否加入系统path，并重启终端验证。
go version 命令报错或不识别
说明 go 没进系统 PATH，不是安装失败，而是路径没生效。
Windows 用户常见于：安装时没勾选 Add Go to PATH（.msi 安装器里有这个选项），或手动配置了 GOROOT 但漏掉了 %GOROOT%\bin 加入 Path 系统变量。
- 检查
GOROOT是否指向真实安装目录（如C:\Go），且该目录下存在bin\go.exe - 确认
Path中包含%GOROOT%\bin（非C:\Go\bin这种硬编码，避免迁移后失效） - CMD/PowerShell 需要**重启**才能读取新环境变量，改完别忘了新开终端再试
go env -w GOPROXY 后依赖仍下载失败
问题不在代理设置本身，而在于 GO111MODULE 实际未启用 —— 多数人只设了代理，却忽略了模块开关是前提。
执行 go env 查看输出，重点确认这两项：
-
GO111MODULE="on"（不是"auto"或空） -
GOPROXY="https://goproxy.cn,direct"（注意逗号后必须带direct，否则私有模块会失败）
若任一不满足，补上命令：
go env -w GO111MODULE=on<br>go env -w GOPROXY=https://goproxy.cn,direct
注意：Linux/macOS 用户若用 zsh，改完 ~/.zshrc 后需 source ~/.zshrc，否则 go env 显示的仍是旧值。
新建项目时 go mod init 报错 “working directory is not part of a module”
这不是错误，是提示你当前目录没初始化模块 —— 但真正卡住的原因往往是：你在 $GOPATH/src 下直接建项目，而 Go 1.13+ 默认拒绝在 GOPATH 内自动启用 module。
- **别再把项目放
%GOPATH%\src里**，现代 Go 项目可建在任意路径，比如D:\myapp或~/projects/myapp - 进目标目录后，直接运行
go mod init example.com/myapp（模块名建议用域名格式，避免冲突） - 如果已有
go.mod但内容为空或格式异常，删掉它再重试go mod init
顺带一提：go mod init 不会自动创建文件夹，mkdir myapp && cd myapp 这步不能省。
VS Code 中 Go 扩展提示 “command ‘go.gopath’ not found”
这是旧版 Go 扩展残留问题，新版扩展（v0.38+）已移除对 GOPATH 的强依赖，但缓存或配置可能还在引用旧逻辑。
- 卸载 VS Code 中的 Go 扩展，重启编辑器，再从 Marketplace 重新安装最新版
- 检查用户设置中是否手动写了
"go.gopath"相关配置，删掉整段 - 确保 VS Code 终端继承了系统环境变量：设置里开
"terminal.integrated.inheritEnv": true
真正关键的是：只要 go version 和 go env 在 VS Code 内置终端里能正常执行，语法高亮、跳转、格式化这些核心功能就不会丢 —— GOPATH 对现代 Go 开发已是可选项，不是必填项。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
