经典款Golang环境搭建及初学者编译指南-Golang-PHP中文网

go二进制未进path导致go version无输出，需重启终端或手动添加%goroot%\bin到系统path；go mod init报错因目录不在gopath/src且未指定模块名，应运行go mod init example.com/myapp；国内拉包失败多因goproxy未生效，应执行go env -w goproxy=https://goproxy.cn,direct。

经典款golang环境搭建及初学者编译指南

go version 命令报错或无输出

说明 Go 二进制没进 PATH，不是安装失败，而是环境变量没生效。Windows 下 .msi 安装虽自动写入 Path，但旧 CMD/PowerShell 窗口不会刷新变量。

必须关闭所有已打开的终端窗口，重新启动 CMD 或 PowerShell 再试
检查 go 是否在 %GOROOT%\bin 目录下（默认是 C:\Program Files\Go\bin）
若仍不行，手动把该路径加到系统 Path 环境变量里（注意不是用户变量）
别用 Git Bash 验证——它不继承 Windows 系统环境变量，除非你额外配置

go mod init 报错：‘cannot determine module path’

这是新手最常卡住的地方：当前目录不在 GOPATH/src 下，又没显式指定模块名，go mod init 就不知道该叫什么。

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

执行前先确认你在项目根目录，且该目录有 main.go 或其他 .go 文件
直接运行 go mod init example.com/myapp，模块名可以是任意合法域名格式（不需要真实存在）
别用中文路径、空格路径或桌面路径——Windows 上某些符号或权限会导致 go mod 初始化失败
如果只是临时测试，用 go run . 可跳过模块初始化（Go 1.16+ 支持）

go run 和 go build 的行为差异

go run 是编译+执行，go build 只编译不执行，但两者对工作目录和包结构的依赖完全不同。

go run .：要求当前目录含 main 包，且只有一个 main() 函数；支持多文件，但不能有重复 main 包
go build 默认生成同名可执行文件（如 main.exe），加 -o 才能指定输出名，比如 go build -o app.exe
go build ./cmd/app：会去子目录找 main 包，适合多命令项目；而 go run ./cmd/app 也合法，但只运行那个子包
如果 go run 提示 “no Go files in current directory”，说明没找到 package main，检查文件扩展名是不是 .go，内容有没有漏写 package main

国内拉包超时或 get 失败：GOPROXY 没生效

go get 或 go mod download 卡住、报 timeout 或 connection refused，大概率是代理没配对或被覆盖。

执行 go env GOPROXY，输出必须是类似 https://goproxy.cn,direct，而不是空或 https://proxy.golang.org,direct
如果输出不对，运行 go env -w GOPROXY=https://goproxy.cn,direct（注意逗号后不能有空格）
某些 IDE（如 VS Code）会读取自己的 shell 环境，启动前没加载 go env 设置，建议在 IDE 终端里单独执行一次 go env -w
验证是否生效：go mod download github.com/gin-gonic/gin@v1.9.1，几秒内完成即 OK