搭建Golang环境并熟悉常用标准库的使用-Golang-PHP中文网

go version报command not found说明path未生效，需检查go二进制路径是否加入环境变量：windows用get-command go验证，macos/linux用which go，并确保对应shell配置文件（如~/.zshrc）正确导出path后source生效。

搭建golang环境并熟悉常用标准库的使用

说明 PATH 没生效，不是没装好，而是终端找不到 go 可执行文件。

Windows：用 PowerShell 运行 Get-Command go；若无输出，去「系统属性 → 高级 → 环境变量」确认 C:\Program Files\Go\bin（或你安装的实际路径）已加入系统或用户 PATH
macOS/Linux：运行 which go；若为空，检查 ~/.zshrc 或 ~/.bash_profile 是否写了 export PATH=$PATH:/usr/local/go/bin（macOS pkg 安装默认是 /usr/local/go/bin），然后执行 source ~/.zshrc
统信 UOS 等国产系统若用 APT 安装，可能装的是 golang-go 包，实际二进制名是 go，但部分镜像源会缺 symlink，可手动创建：sudo ln -s /usr/lib/go-1.22/bin/go /usr/local/bin/go

不是命令写错，而是当前目录“身份可疑”，go mod init 会静默退化或推导出错误 module 名。

Golang Spf13 Viper

Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。

下载

项目目录在 $GOPATH/src 下（比如 ~/go/src/hello）：Go 会尝试按旧 GOPATH 规则生成 module 名，如 hello，而非你想要的 example.com/hello。解决方法：直接切到任意非 $GOPATH/src 路径新建项目，例如 mkdir ~/projects/hello && cd ~/projects/hello
存在 vendor/ 目录：模块模式会绕过 go.mod 自动加载 vendor 内容，导致 go mod init 不生成预期依赖项。删掉 vendor/ 再试
GO111MODULE=off：老脚本或 CI 环境可能关了模块模式。强制开启：go env -w GO111MODULE=on

不用背文档，从最小可运行片段开始，边改边验证。

fmt：只记两个函数就够了。fmt.Println("hi") 打印带换行；fmt.Printf("name: %s, age: %d\n", name, age) 格式化输出。注意 %v 是万能占位符，调试时比 fmt.Print 直接打印结构体更安全
net/http：启动一个 HTTP server 只需三行：
```
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintf(w, "Hello, world!")
})
http.ListenAndServe(":8080", nil)
```
如果端口被占，换 :8081；想返回 JSON，把 fmt.Fprintf 换成 w.Header().Set("Content-Type", "application/json"); json.NewEncoder(w).Encode(map[string]string{"msg": "ok"})
os：读写文件优先用 os.ReadFile 和 os.WriteFile（Go 1.16+），它们自动处理打开/关闭和 error。别再手写 f, _ := os.Open(...); defer f.Close()，除非你需要流式读取大文件

因为模块模式（Go Modules）接管了依赖管理和构建路径，GOPATH 不再决定代码存放位置或 import 解析逻辑。

GOROOT 仍必须存在（指向 Go 安装目录），但 GOPATH 的 src 子目录已废弃。你可以在任何路径下 go mod init example.com/foo，Go 就认这个目录为 module 根
GOBIN 默认是 $GOPATH/bin，但如果你只用 go run 或 go build，根本不需要它；只有当你频繁用 go install 安装 CLI 工具（比如 gopls）时，才需要确保 GOBIN 在 PATH 中
VS Code 的 gopls 启动失败，90% 是因为当前文件夹没有 go.mod，或者 go 命令本身不可用——先跑 go version 和 go list 验证，别急着重装插件