Go环境配置成功需满足go version有输出、go env中GOROOT指向/usr/local/go且GOPATH非空；常见问题依次为PATH未生效、二进制无执行权限、模块代理未配置、main包缺失或路径错误、go.mod未初始化。
Linux服务器上装Go，不用折腾系统包管理器，直接下二进制包解压配置PATH就行；go version能输出版本号、go env里GOROOT指向/usr/local/go且GOPATH有值，就代表环境已就位。后续编译运行测试程序失败，90%是权限、路径或模块配置问题，不是Go本身出错。
为什么go命令提示“command not found”
PATH没生效是最常见原因，尤其在非交互式 Shell（如通过ssh直连后执行脚本）中source ~/.bashrc可能不触发。
- 检查
which go是否返回空 —— 如果空，说明/usr/local/go/bin根本没进PATH - 确认写入的是
~/.bashrc还是~/.profile：Ubuntu默认读~/.profile，CentOS默认读~/.bashrc -
echo $PATH看输出里有没有/usr/local/go/bin；没有就手动加：export PATH=$PATH:/usr/local/go/bin - 如果用
sudo su -切换用户，会加载root的配置文件，而不是你当前用户的 —— 别在root下验证普通用户环境
go build成功但./hello报“Permission denied”
Linux默认不给可执行文件执行权限，go build生成的二进制文件只是普通文件，没x位。
- 运行前必须显式加权：
chmod +x ./hello - 更省事的做法是编译时直接指定输出并运行：
go build -o ./hello && chmod +x ./hello && ./hello - 注意：不要用
go run main.go代替测试 —— 它绕过文件权限检查，会掩盖真实部署问题
启用Go Modules后go mod tidy卡住或报错
国内网络环境下，不配代理几乎必卡在golang.org/x/...这类域名上，错误常表现为go: downloading ...: reading ...: Get "https://...": dial tcp: lookup ...: no such host。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 必须设置代理：
go env -w GOPROXY=https://goproxy.cn,direct（推荐goproxy.cn，比官方proxy.golang.org稳定） - 同时关掉校验和数据库干扰：
go env -w GOSUMDB=off（仅开发测试用；生产环境建议保留sum.golang.org） - 如果项目已有
go.mod但内容为空或格式异常，先删掉它再go mod init your-module-name -
go mod tidy必须在项目根目录执行，且当前目录下要有main.go或至少一个.go文件被import引用
go run能跑，go build却找不到main函数
这不是环境问题，是Go对入口包的硬性约束：只有package main且含func main()的文件才能生成可执行文件。
- 确认
main.go第一行是package main，不是package hello或package myapp - 如果项目有多个
.go文件，全部都要在同一个目录下，且不能分散在子目录里 ——go build默认只扫当前目录 - 想编译子目录里的main包？得显式指定路径：
go build ./cmd/server，前提是./cmd/server下有package main - 别依赖IDE自动补全的
package xxx—— 新建文件时手敲package main最稳妥
真正容易被忽略的点是：Go Modules默认开启后，go build会严格按go.mod解析依赖，哪怕你只是写个fmt.Println也得先go mod init。不初始化就编译，Go会退回到老式GOPATH模式，而现代Linux服务器通常没设GOPATH/src结构，结果就是“找不到包”。
