从零配置Golang环境搭建与程序编译打包-Golang-PHP中文网

go环境配置需显式设置goroot、启用go111module、配置goproxy，仅go version成功不代表可用；go build必须加-ldflags="-s -w"减体积去调试信息，静态链接还需-tags netgo -ldflags "-extldflags '-static'"（macos除外）。

从零配置golang环境搭建与程序编译打包

能跑 go run 不代表环境就配对了——很多看似成功的安装，实际缺 GOROOT、漏 GOPROXY、或 go mod 根本不生效，编译出的二进制在别的机器上直接报错。

go version 能输出 ≠ 环境可用

很多人执行 go version 看到版本号就以为完事了，但真实项目里会立刻暴露问题：

执行 go build 报错 cannot find module providing package fmt：说明没启用模块模式，或 GO111MODULE 没设为 on
go get github.com/sirupsen/logrus 卡住或超时：默认代理走国外，国内必须配 GOPROXY
go env GOROOT 输出空：GOROOT 未显式设置，某些 IDE 或 CI 场景下会找不到标准库路径
用 go run main.go 成功，但 go build -o app main.go 生成的可执行文件在另一台机器运行时报 failed to load system cert pool：静态链接没开，依赖系统 OpenSSL 库

Windows 上 .msi 安装后仍要手动补三件事

.msi 包确实自动写入了 PATH，但它不设 GOROOT（除非你改注册表），也不配代理，更不启用模块——这些必须自己补：

Colly Golang Web Scraper and Crawler Framework

Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。

下载

打开 PowerShell，逐条执行（不是 CMD）：

go env -w GOROOT="C:\Program Files\Go"
go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct

验证是否生效：go env GOROOT 必须输出路径；go env GOPROXY 必须含 goproxy.cn
关闭并重开所有终端窗口——Windows 环境变量不会热更新

Linux/macOS 手动解压后 PATH 和 GOROOT 必须显式声明

tar.gz 解压到 /usr/local/go 后，仅加 /usr/local/go/bin 到 PATH 是不够的。很多工具（如 VS Code Go 插件、dlv 调试器）依赖 GOROOT 找标准库源码：

在 ~/.zshrc 或 ~/.bashrc 里写死两行：

export GOROOT=/usr/local/go
export PATH=$PATH:$GOROOT/bin

别漏掉 source ~/.zshrc；如果用了 Oh My Zsh，确认插件没覆盖 PATH
go env GOROOT 和 echo $GOROOT 输出必须一致

go build 静态打包要加 -ldflags="-s -w"

默认 go build 生成的二进制带调试符号、动态链接 libc，体积大且跨机器易失败。生产打包必须加参数：

go build -ldflags="-s -w" -o app main.go：去掉符号表和 DWARF 调试信息，体积减半
想彻底静态链接（避免 libc 版本不兼容）：加 -tags netgo -ldflags "-extldflags '-static'"
注意：-s -w 会让 panic 堆栈不显示行号；调试阶段先不用，上线前再加
macOS 上静态链接不可行（系统限制），只能靠 -s -w 减体积

真正麻烦的从来不是第一次 go run 成功，而是三个月后你把编译好的二进制发给客户，对方双击闪退——那时候才意识到当初没配 GOPROXY 导致依赖版本混乱，也没开静态链接。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！