go环境配置核心在于path、goproxy和vs code启动方式：需确保go命令被终端识别，goproxy设为https://goproxy.cn,direct，且vs code必须从终端执行code命令启动以继承环境变量。
Go 环境能跑起来，不等于环境搭对了；很多“go version 成功”之后的报错，根源都在 GOPATH 或 Go Modules 配置上。
go version 显示成功但 go run 报错 command not found
这是 Windows 用户最常遇到的假成功——安装程序虽自动写入 PATH，但 PowerShell 或 CMD 会缓存旧环境变量，导致新开终端仍找不到 go 命令。
- 打开新终端（不是“重新运行”旧窗口），再执行
go version - 若仍失败，手动检查
PATH是否含C:\Program Files\Go\bin（Windows）或/usr/local/go/bin（macOS/Linux） - 别依赖安装程序的“自动配置”，尤其用 MSI 安装后没重启终端，
go mod init就会直接报command not found
GOROOT 和 GOPATH 的实际作用被严重高估
Go 1.16+ 默认启用 Go Modules，GOROOT 仅指向 Go 安装根目录（如 C:\Program Files\Go），GOPATH 对绝大多数项目已无实质影响——它只决定 go install 编译后的二进制存放位置（$GOPATH/bin），而非项目源码位置。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 不用为每个项目设不同
GOPATH；现代项目直接在任意目录下go mod init myapp即可 -
GOROOT一般无需手动设置，除非你解压 zip 包到非标路径且没加PATH - 真正要盯紧的是
GO111MODULE：确认它是on（推荐）或auto，避免误入 GOPATH 模式导致依赖无法下载
国内用户执行 go mod download 总卡住
Go Modules 默认从 proxy.golang.org 拉包，国内直连基本超时，但错误提示常是模糊的 no required module provides package 或 Get \"https://proxy.golang.org/...\": dial tcp: i/o timeout。
- 立刻执行：
go env -w GOPROXY=https://goproxy.cn,direct（cn 站稳定，支持私有模块回源） - 验证是否生效：
go env GOPROXY应输出https://goproxy.cn,direct - 如果公司内网禁外网，需配
direct后缀，否则私有模块会因代理不可达而失败 - 别用
export GOPROXY=...临时设置——go 命令可能读不到 shell 环境变量，必须用go env -w
VS Code 中 go extension 提示 “Go tools not installed”
这不是插件问题，而是 VS Code 启动时没继承系统 PATH 中的 go 路径，尤其 macOS 上通过 Spotlight 启动 VS Code 时最常见。
- 关闭所有 VS Code 实例，从终端启动：
code --new-window - 在 VS Code 终端里运行
which go，确认路径和go version一致 - 如果 still missing，手动在 VS Code 设置里搜
go.toolsGopath，留空（现代模式下不需要填） - 真正要装的工具是
gopls（语言服务器），它由插件自动拉取；若卡住，先go install golang.org/x/tools/gopls@latest
环境变量、代理、工具链三者只要一个没对齐，go run 就可能在 0.1 秒内失败，但错误信息几乎不告诉你具体哪一环断了。动手前先确认这三点：终端能认 go、go env GOPROXY 有值、VS Code 是从终端启的。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
