如何在全新安装的系统上进行一步到位的Golang环境搭建与编译-Golang-PHP中文网

windows全新安装go后，必须立即配置模块代理和启用模块系统才能正常编译运行项目；执行go env -w go111module=on、go env -w goproxy=https://goproxy.cn,direct、go env -w gosumdb=sum.golang.org三条命令并新开powershell验证，否则go mod init会卡住、go get超时失败。

如何在全新安装的系统上进行一步到位的golang环境搭建与编译

直接执行这三条命令就能跑起来

Windows 上全新安装 Go 后，go version 能输出版本号只是第一步；真正能编译运行项目，必须立刻配置模块代理和启用模块系统。否则 go mod init 会卡住，go get 会超时失败。

打开 PowerShell（不是 CMD），以管理员身份非必需，但确保窗口是新打开的（旧窗口不读取新环境变量）
逐行执行以下命令（复制粘贴即可）：

go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct
go env -w GOSUMDB=sum.golang.org

执行后立即验证：go env | findstr "GO111MODULE\|GOPROXY" 应看到两行匹配结果。注意：不要用 set 或 $env: 临时设置，那些只在当前会话生效，重启就丢。

别碰 GOPATH，除非你明确要管理旧项目

Go 1.16+ 默认启用 Modules，GOPATH 对日常开发已无实质影响。新建项目完全不需要把代码放到 %GOPATH%\src 下，也不需要提前创建 src、bin、pkg 目录。

Golang Google Wire

在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface

下载

随便建个空文件夹，比如 D:\myapp，进目录后直接 go mod init myapp
main.go 可以放在任意位置，只要在模块根目录下就行
如果误设了 GOPATH 且路径含空格或中文，反而会导致 go install 失败或工具链报错

编译时 go build 和 go run 的关键区别

go run 是调试首选，但它的行为和 go build 不同，容易掩盖路径或依赖问题。

go run main.go：只编译并运行当前文件，不生成可执行文件，也不检查 go.mod 是否完整
go build -o app.exe：强制校验整个模块依赖，生成独立二进制，适合交付
常见坑：go run .（注意点号）才等价于 go build 的模块级行为；单独 go run *.go 可能漏包

VS Code 里 go tools 安装失败？先关掉自动代理

VS Code 的 Go 扩展默认调用 go install 拉取 gopls、dlv 等工具，但若系统代理或公司防火墙干扰，会卡在 “Fetching tools…”。

不要在 VS Code 里点 “Install All” —— 先手动在终端执行：go install golang.org/x/tools/gopls@latest
如果失败，加 -v 看具体哪个模块拉不到，再针对性 go install 单个工具
确认 GOPROXY 生效后，再回到 VS Code 触发重试，否则扩展会反复走失败路径

模块初始化、依赖下载、二进制构建这三步环环相扣，任何一环代理没配稳，都会表现为“明明能 go version，却跑不起来 hello world”。最常被忽略的是：PowerShell 环境变量刷新必须新开窗口，不是 source 或 refreshenv 能解决的。