go version成功但go run报“command not found”是Windows用户MSI安装后环境变量未生效所致，需关闭所有终端重开，并确认PATH包含Go的bin目录（如C:\Go\bin）。
go version 输出版本但 go run 报错“command not found”
这是 Windows 用户装完 .msi 包后最常见的假性成功——环境变量没生效。安装程序确实写了 GOROOT 和 PATH，但 CMD/PowerShell 不会自动继承新变量。
- 必须关闭所有已打开的终端窗口（包括 VS Code 内置终端、Git Bash、甚至旧的 PowerShell 标签页）
- 重新打开一个全新终端，再执行
go version和go env | findstr GOROOT - 如果
go run仍报错，说明PATH里没包含C:\Program Files\Go\bin（或你自定义的安装路径下的\bin） - 手动检查系统环境变量：右键“此电脑”→属性→高级系统设置→环境变量→查看“系统变量”里的
Path是否含 Go 的 bin 目录
游戏服务器必须开 GO111MODULE=on 吗？
必须。哪怕你只写一个 main.go，只要用到 net/http 或第三方库（比如 github.com/gorilla/websocket），关掉模块就会出问题。
-
GO111MODULE=off时，go get会往GOPATH/src写代码，而现代游戏服务依赖结构复杂，无法靠目录路径管理版本 - 不开启模块，
go build会忽略go.mod，导致本地改了依赖却编译出旧版本 - Windows 下执行：
go env -w GO111MODULE=on（永久生效） - 验证：
go env GO111MODULE应输出on
为什么 go build -ldflags="-s -w" 是游戏服上线前必加项？
这不是可选项，是减少攻击面和启动延迟的实际手段。默认编译出的二进制带调试符号和 DWARF 信息，对游戏服毫无价值，反而增大体积、拖慢加载。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
-
-s：剥离符号表，减小体积（常压缩 30%+） -
-w：禁用 DWARF 调试信息，防止逆向分析关键逻辑（如协议加密、防外挂校验） - 实测：某 TCP 游戏网关从 12.4MB → 8.7MB，冷启动快 180ms
- 注意：
-ldflags必须紧接在go build后，不能写成go build -ldflags "-s -w" .（引号位置错会导致参数被忽略）
GOPROXY 设成 https://goproxy.cn,direct 还是 https://goproxy.io,direct？
用 https://goproxy.cn。截至 2026 年 7 月，goproxy.io 已停服，且其 CDN 节点在国内多数失效；goproxy.cn 由七牛云维护，支持 go 1.25+，镜像更新及时，direct 回源也稳定。
立即学习“go语言免费学习笔记（深入）”；
- 错误配置示例：
go env -w GOPROXY=https://proxy.golang.org,direct—— 这个地址在国内基本超时 - 正确命令：
go env -w GOPROXY=https://goproxy.cn,direct - 验证方式：
go list -m -f '{{.Dir}}' golang.org/x/net，能快速返回路径即代理生效 - 若公司内网有私有 proxy，应优先配内部地址，
direct放最后作兜底
-trimpath 参数。它抹掉源码绝对路径，避免泄露开发机用户名或项目路径——这对游戏服尤其敏感，因为反编译后路径可能暴露内部目录结构或测试环境标识。 
