Go环境配置问题八成源于路径或版本错误：Windows需设PowerShell执行策略为RemoteSigned，macOS/Linux要确保PATH包含Go二进制路径，go mod init应在任意目录执行而非GOPATH/src，GOPATH无需手动设置，国内必须配置GOPROXY代理。
Go 环境装不上、go 命令不识别、go mod 报错“unknown directive”，八成是路径或版本没对，不是你手速慢。
Windows 上用 PowerShell 安装 Go 时卡在 Execution Policy 报错
这是 Windows 10/11 最常见的拦路虎，错误信息通常是：Execution policies prevent the script from running。PowerShell 默认策略禁止执行本地脚本，但 Chocolatey 或自定义安装脚本必须运行——它不是安全风险，而是系统默认保守策略。
- 以管理员身份打开 PowerShell，执行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 别用
Unrestricted，RemoteSigned已足够且更安全 - 执行后重启终端，再运行
choco install golang或手动解压安装包 - 注意：如果用户名含中文或空格（如
C:\Users\张三\），建议把GOPATH显式设到不含空格的路径，例如C:\gopath，否则某些旧版工具（如go get早期行为）会静默失败
macOS/Linux 下用 brew/apt 安装 Go 后 go 找不到命令
根本原因不是没装上，而是 PATH 没生效。brew 和 apt 安装的 Go 二进制路径和官方推荐路径不一致：brew 装在 /opt/homebrew/bin/go（Apple Silicon）或 /usr/local/bin/go（Intel），apt 可能装在 /usr/bin/go，而 shell 初始化文件（~/.zshrc 或 ~/.bashrc）里没加进去。
- 先查真实路径：
which go或find /usr -name go 2>/dev/null - 把对应目录加进 PATH：比如 brew 装的，就加
export PATH="/opt/homebrew/bin:$PATH" -
别漏掉重载配置：
source ~/.zshrc（macOS Sonoma+ 默认 zsh）或source ~/.bashrc - 验证：
go version必须输出类似go version go1.22.5 darwin/arm64，否则 PATH 没生效
go mod init 失败，提示 “go.mod already exists” 或 “not in a directory tree rooted at $GOPATH”
这是 Go 1.16+ 模块模式下的典型误判。现代 Go 已完全脱离 $GOPATH/src 目录约束，但很多人仍习惯把项目建在 $GOPATH/src 下，反而触发兼容逻辑报错。
立即学习“go语言免费学习笔记（深入）”；
- 新建项目时，**直接在任意干净目录下执行**：
go mod init myapp，不要先进入$GOPATH/src - 检查当前目录是否已有
go.mod：有就删掉重来；没有却报“already exists”，说明父目录有，cd 进子目录再试 -
GOPATH不再需要手动设置，除非你要改模块缓存位置（默认在$HOME/go），此时只设GOBIN或GOPROXY更实用 - 国内务必配代理，否则
go mod download会超时：go env -w GOPROXY=https://goproxy.cn,direct
VSCode 中 Go 扩展不工作：gopls 启动失败或跳转失效
根本原因常是 VSCode 用了系统 PATH 之外的 Go 版本，或者 gopls 本身没随 Go 安装（Go 1.21+ 默认自带，但旧版需手动装）。
- 在 VSCode 终端里运行
go version和系统终端对比，不一致就说明 VSCode 没读对 PATH - 在 VSCode 设置中搜
go.goroot，手动填入你实际安装的 Go 根目录（如/usr/local/go或C:\Program Files\Go） - 禁用所有非必要 Go 插件，只留官方
Go扩展（由 golang.org 提供） - 首次打开项目时，右下角弹出“install all tools?”，**一定点“Install All”**，否则
gofmt、gopls等工具缺失
最易被忽略的是：Go Modules 的启用不依赖任何配置开关，只要目录下有 go.mod 就自动生效；但如果你在旧项目里补加 go mod init，又没清理掉 vendor/ 目录，go build 仍可能走 vendor 模式——这时候得加 -mod=mod 强制用模块。细节不起眼，但一卡就是半小时。
