极速构建Golang环境搭建与代码打包编译-Golang-PHP中文网

go 1.16+ 默认启用 go mod，无需配置 gopath 即可编译运行；go version 失败主因是 path 未包含 go bin 目录或 goroot 冲突；常见错误包括 command not found、no go files、import 路径不匹配及 cgo 导致交叉编译失败。

极速构建golang环境搭建与代码打包编译

Go 环境不用配 GOPATH 也能跑，go mod 默认启用（Go 1.16+），装完就能写、编译、打包，不折腾。

go version 验证失败？检查 PATH 和 GOROOT 是否冲突

常见错误现象：command not found: go 或 go: command not found，即使安装了 MSI/.pkg 也报错。

Windows：确认安装时勾选了「Add Go to PATH」；若手动安装，需把 C:\Go\bin（或自定义安装路径下的 \bin）加进系统 PATH
macOS/Linux：检查 GOROOT 是否被错误覆盖——比如在 ~/.zshrc 里写了 export GOROOT=...，但指向了一个不存在的路径；运行 go env GOROOT 看输出是否合理（通常是 /usr/local/go 或 /opt/homebrew/Cellar/go/xxx/libexec）
别用第三方脚本一键配置环境变量，尤其带「自动设 GOPATH」的，容易和现代 Go 冲突

go build 编译失败：main 包文件缺失或路径不对

错误信息常为：no Go files in current directory 或 package main is not a main package。

Colly Golang Web Scraper and Crawler Framework

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

下载

go build 默认只编译当前目录下所有 .go 文件，且要求至少有一个文件声明 package main 并含 func main()
如果 main.go 在子目录（如 cmd/myapp/main.go），必须显式指定路径：go build cmd/myapp，不能只在根目录跑 go build
多个 main 文件（如 main.go + cli.go）要一起编译：go build main.go cli.go；漏掉任一，func main() 就找不到
注意文件编码：Windows 记事本保存可能带 BOM，导致 package main 解析失败，用 VS Code 或 vim 保存为 UTF-8 without BOM

交叉编译生成跨平台二进制：CGO_ENABLED=0 是关键

想从 macOS 编译 Linux 二进制却得到 cannot execute binary file: Exec format error？大概率没关 CGO。

默认开启 CGO，会链接目标平台本地 C 库，导致跨平台失败；加 CGO_ENABLED=0 强制纯 Go 模式
正确命令示例：CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o myapp-linux main.go
GOOS 和 GOARCH 必须成对出现，单独设一个无效；常用组合：GOOS=windows GOARCH=386、GOOS=darwin GOARCH=arm64
-o 参数可用，网上说「不能用」是旧版误解（Go 1.12+ 已修复），但注意输出名要带扩展名（如 .exe）才方便 Windows 识别

go mod init 后 import 报错：模块路径与实际目录不匹配

新建项目后执行 go run main.go 却提示：import "xxx" is a program, not an importable package 或 cannot find module providing package。

go mod init 的参数（如 go mod init github.com/user/project）只是模块标识符，不影响文件物理位置；但后续 import 路径必须和该标识符前缀一致
例如模块名设为 example.com/app，则 import "example.com/app/utils" 对应的文件必须在 ./utils/xxx.go，不能放在 ./lib/utils/
如果只是本地开发、无远程发布计划，用 go mod init myapp（任意合法名称）最省事，所有 import 直接用相对路径 "myapp/utils"
删掉 go.mod 和 go.sum 重来比硬调路径更快