go开发环境能跑起来只需三件事：go命令可用、go mod能拉包、编辑器能识别语法和跳转；核心是确保path/goroot正确、goproxy设为国内镜像、gopls安装到位且go env配置无误。
Go 开发环境能跑起来，核心就三件事：go 命令可用、go mod 能拉包、编辑器能识别语法和跳转。其余都是锦上添花，别被“完整配置”带偏节奏。
go 命令找不到？先查 PATH 和 GOROOT
这是 Windows/macOS/Linux 三端最常卡住的第一步。不是安装失败，而是 shell 没找到 go 可执行文件。
- Windows 用户装
.msi包后默认已配好，但若手动解压或重装过，需确认系统环境变量中PATH是否包含%GOROOT%\bin（比如C:\Go\bin） - macOS/Linux 用户常见错误是只解压了
go到/usr/local/go，却忘了把$GOROOT/bin加进PATH—— 检查echo $PATH输出里有没有/usr/local/go/bin -
GOROOT必须指向 Go 安装根目录（如/usr/local/go），不能指向bin子目录；它不等于项目路径，也和GOPATH无关 - 验证方式：新开终端，运行
which go（macOS/Linux）或where go（Windows），再执行go version看是否输出版本号
go get 或 go mod tidy 报错 “timeout” 或 “no such host”？立刻换 GOPROXY
国内直连 proxy.golang.org 基本不可用，这不是网络问题，是源本身被阻断。必须显式设置国内镜像代理。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 执行命令即可生效（无需重启终端）：
go env -w GOPROXY=https://goproxy.cn,direct
或更稳的阿里源：go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct - 注意结尾的
,direct不能省——它表示对私有模块（如公司内网 Git）不走代理，直接拉取 - 如果项目已存在
go.mod但依赖混乱，先删掉go.sum，再跑go mod tidy，避免缓存干扰 - 不推荐用
export GOPROXY=...方式临时设置，容易在不同 shell 间失效；go env -w是持久化写入go env配置的唯一可靠方式
VS Code 中无法跳转定义或提示空白？gopls 没装或没识别 GOPATH
VS Code 的 Go 扩展依赖 gopls（Go language server）提供智能提示。它不读 IDE 设置，只认 go env 输出的环境变量。
- 先在终端运行
go install golang.org/x/tools/gopls@latest安装语言服务器（注意不是go get） - 确保
gopls二进制落在$GOPATH/bin下，且该路径已在PATH中——否则 VS Code 启动时找不到它 - VS Code 不需要手动配置
GOROOT或GOPATH，但它会读取go env结果。如果go env GOPATH输出为空，gopls可能降级为只处理单文件，失去跨包跳转能力 - 打开 VS Code 后，按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入 “Go: Install/Update Tools”，勾选gopls并安装，比手敲命令更稳妥
go mod init 后 import 本地包报错 “cannot find module”？路径与模块名不一致
Go Modules 不靠文件系统路径推断模块名，而是严格依赖 go.mod 第一行的 module example.com/myproj。一旦写错，所有相对导入都会失效。
- 初始化时不要用本地路径如
go mod init ./src/myapp，而应指定一个语义化模块路径：go mod init github.com/yourname/myapp - 如果已初始化错，直接编辑
go.mod文件第一行，改掉module值，然后执行go mod edit -fmt格式化，并用go mod graph | head -5快速验证依赖图是否合理 - 本地子包导入必须用完整模块路径，例如模块名为
github.com/yourname/myapp，则myapp/internal/utils包应被导入为"github.com/yourname/myapp/internal/utils"，不能写"./internal/utils" - 别把
go mod当成 GOPATH 的替代品——它不改变 import 查找逻辑，只是让包可以脱离固定目录结构
真正容易被忽略的点是：Go 工具链本身不依赖 IDE，但 IDE 严重依赖 go env 的输出结果。所有配置最终都要回归到 go env 命令能看到的值，而不是你编辑器里填的某个字段。每次怀疑配置失效，先开终端跑一遍 go env，比翻十页文档都管用。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
