答案：go命令能运行且go build生成二进制即环境正确，无需IDE、GOPATH/src或vendor；验证需确保PATH生效（macOS/Linux用which go，Windows用Get-Command go），go mod init失败主因是目录在GOPATH/src下、存在vendor目录或GO111MODULE=off；gopls启动依赖go可用、含go.mod或main.go且文件后缀为.go，并建议配置GOPROXY。
go 命令能跑起来，go build 能出二进制，就说明环境搭对了——不需要 IDE、不用配 GOPATH/src、更别碰 vendor/。
验证 go 命令是否真可用
很多人执行 go version 报 command not found，不是没装，是 PATH 没生效。
- macOS / Linux：运行
which go，没输出就说明路径没加进 shell 配置（比如~/.zshrc或~/.bashrc），检查是否漏了export PATH=$PATH:/usr/local/go/bin这行 - Windows：在 PowerShell 里跑
Get-Command go，失败就去「系统属性 → 高级 → 环境变量」确认C:\Program Files\Go\bin（或你实际安装路径）进了系统或用户 PATH - 别信安装器“自动添加 PATH”的勾选框——它只改注册表或配置文件，不自动 reload 终端；改完记得关掉终端重开，或者手动
source ~/.zshrc
go mod init 失败的三个典型原因
运行 go mod init example.com/hello 却没生成 go.mod，或报错说 “cannot determine module path”，大概率是卡在这几个地方：
- 当前目录在
$GOPATH/src下（比如~/go/src/xxx）：Go 会试图按旧 GOPATH 规则推导 module 名，直接切到任意其他目录再试（如~/workspace/hello） - 项目里还留着
vendor/目录：删掉它，go mod init才会干净初始化 -
GO111MODULE被设为off：执行go env -w GO111MODULE=on强制启用模块模式（Go 1.16+ 默认开启，但某些旧脚本或 CI 可能关着）
本地打包编译：go build 的实用姿势
go build 不是黑盒命令，参数选错会导致跨平台失败、体积膨胀或运行报错。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 默认编译当前目录下的
main包：确保有package main和func main()，否则报no Go files in - 指定输出名：
go build -o myapp（Linux/macOS）或go build -o myapp.exe（Windows） - 交叉编译注意
GOOS/GOARCH：比如在 macOS 上编译 Windows 版，先export GOOS=windows再go build -o myapp.exe；但注意标准库和 cgo 依赖可能不兼容 - 禁用调试信息减小体积（发布用）：
go build -ldflags="-s -w" -o myapp
VS Code 里 gopls 启动失败，别急着重装插件
gopls 是语言服务器，不是插件本身。它启动失败，90% 是因为底层条件没满足：
-
go命令必须在终端里能直接调用（which go有输出） - 打开的文件夹必须含
go.mod（或至少有main.go且不在GOPATH/src下） - 文件后缀得是
.go；如果误存成.txt或没后缀，gopls就不认 - 国内用户常卡在工具下载：执行
go env -w GOPROXY=https://goproxy.cn,direct再重启 VS Code
模块名写法、GOOS 值大小写、go.mod 里 require 行末尾的版本号格式——这些细节看着琐碎，但任一个错都会让 go build 或 gopls 在某个环节静默失败。动手前先 go env 看一眼真实配置，比反复重装快得多。
