go开发环境关键在于go命令可用、go mod init不报错、go run main.go输出hello world；常见问题为旧版go（如1.16）、残留gopath/src路径或path未生效，占“搭不起来”投诉的80%。
直接上手就能跑的 Go 开发环境，关键不是装得多全，而是 go 命令能立刻执行、go mod init 不报错、go run main.go 能打出 Hello World——其余都是锦上添花。旧版 Go（如 1.16）、残留 GOPATH/src 路径、PATH 没生效，这三类问题占了 80% 的“环境搭不起来”投诉。
确认 go 命令可用且版本 ≥ 1.18
别急着删重装，先看现状：
- 运行
go version，输出必须是类似go version go1.22.3 darwin/arm64；若提示command not found，说明 PATH 没生效，不是没装 - macOS/Linux 执行
which go，检查路径是否混杂（比如同时存在/usr/local/go/bin/go和~/sdk/go1.20.5/bin/go） - Windows 用 PowerShell 运行
Get-Command go，失败则去「系统属性 → 高级 → 环境变量」里核对%GOROOT%\bin是否在 PATH 中 - 旧版（如 Homebrew 装的 1.16）无法支持泛型和默认模块行为，必须升级；但升级前先
go env GOPATH记下当前值，避免后续go install生成的二进制找不到
go mod init 失败的常见诱因
不是命令写错，而是项目上下文不对：
- 当前目录不能在
$GOPATH/src下——Go 会尝试按旧路径推导 module 名，比如github.com/username/project变成src/github.com/username/project，直接失败 - 项目根目录下有
vendor/目录或GO111MODULE=off环境变量，go mod init会静默跳过或报错；先删vendor/，再运行go env -w GO111MODULE=on - module 名用本地路径（如
go mod init myapp）完全合法，不需要真实域名；但若想用go install全局调用，得保证$GOPATH/bin在 PATH 中 - 初始化后立即运行
go run main.go报no required module？说明go.mod没写入依赖声明，此时补一行require或直接删掉go.mod重试
VS Code 中 gopls 启动失败怎么办
gopls 是语言服务器，不是插件开关决定的，它依赖三个硬条件：
-
go命令必须全局可执行（which go有输出） - 当前打开的文件夹必须含
go.mod文件，且main.go在package main下；否则提示 “no modules found” - 文件后缀必须是
.go，且 VS Code 当前语言模式设为 “Go”（右下角点击切换） - 首次打开 .go 文件时，VS Code 会弹窗提示安装工具链；选 “Install All”，它会拉取
gopls、goimports、dlv等；若卡住，手动运行go install golang.org/x/tools/gopls@latest
国内环境下依赖下载慢或失败
这不是网络问题，是 Go 默认代理被墙导致的必现现象：
- 执行
go env -w GOPROXY=https://goproxy.cn,direct（推荐）或https://mirrors.aliyun.com/goproxy/ - 顺手加一句
go env -w GOSUMDB=sum.golang.google.cn，避免校验失败 - 验证：运行
go env | grep GOPROXY，输出应为GOPROXY="https://goproxy.cn,direct" - 如果已有项目拉过依赖，建议删掉
go.sum并重新go mod tidy，否则旧 checksum 可能和新 proxy 不兼容
最易被忽略的点：PATH 修改后必须重启终端或执行 source ~/.zshrc（macOS/Linux）/ refreshenv（Windows + scoop/choco），否则所有后续操作都在假环境中进行。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
