最可靠Go安装方式是brew install go，自动管理路径与升级；Go 1.16+默认启用模块模式，无需GOPATH/src结构；VS Code需清理旧gopls并让扩展自动管理；交叉编译Linux二进制须设CGO_ENABLED=0。
用 Homebrew 安装 Go，别手动下载 pkg
macOS 上最可靠、最易更新的 Go 安装方式就是 brew install go。手动下载官方 .pkg 安装包看似直观，但会绕过系统包管理，导致后续升级困难、版本冲突难排查，且默认安装路径（/usr/local/go）与 Homebrew 管理路径不一致，容易引发 GOPATH 和 GOROOT 混乱。
Homebrew 安装后，go 二进制自动软链到 /opt/homebrew/bin/go（Apple Silicon）或 /usr/local/bin/go（Intel），并由 brew upgrade go 统一维护。你只需确保 PATH 中该路径在前：
export PATH="/opt/homebrew/bin:$PATH"
验证是否生效：
which go 应输出 /opt/homebrew/bin/go；go version 应显示类似 go version go1.22.4 darwin/arm64。
立即学习“go语言免费学习笔记（深入）”；
关闭 GOPATH 模式，直接用 Go Modules
Go 1.16+ 默认启用模块模式（GO111MODULE=on），不再强制依赖 $GOPATH/src 目录结构。你现在可以任意位置初始化项目，只要运行 go mod init example.com/myapp 即可生成 go.mod。
检查当前模块状态：
go env GO111MODULE 必须是 on（不是 auto 或空）；go env GOPATH 可以保留默认值（如 /Users/xxx/go），但它只用于存放 go install 的二进制和缓存，**不参与源码组织**。
Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。
常见误操作：
- 在
$GOPATH/src下新建项目并期望自动识别为模块 —— 不会，go.mod缺失时仍报no required module provides package - 设
GO111MODULE=auto后，在$GOPATH/src外目录执行go build却意外进入 GOPATH 模式 —— 建议始终显式设为on
VS Code 配置 Go 扩展需关掉旧版 gopls 兼容模式
新版 VS Code Go 扩展（v0.38+）默认使用 gopls 作为语言服务器，但 macOS 上若曾手动安装过老版本 gopls（比如用 go install golang.org/x/tools/gopls@latest 装在 $GOPATH/bin），可能因路径优先级或版本不匹配导致代码补全卡顿、跳转失败或频繁报错 no packages found for open file。
解决方法：
- 删除旧
gopls：rm $(go env GOPATH)/bin/gopls - 在 VS Code 设置中搜索
go.gopls.path，留空（让扩展自动管理） - 确认
go.gopls.usePlaceholders为true，提升补全响应速度 - 首次打开项目时，等待右下角提示 “Indexing…” 完成再操作，避免误判功能失效
交叉编译注意 CGO_ENABLED 和系统库路径
macOS 默认开启 CGO_ENABLED=1，这会让 cgo 调用系统 C 库（如 libc、CoreFoundation）。若你要构建 Linux 二进制（例如部署到 Docker），必须显式关闭：
CGO_ENABLED=0 go build -o myapp-linux main.go
否则会报错：cannot cross-compile C code on darwin。但关掉后也意味着无法使用依赖 C 的包（如 net 包的某些 DNS 解析逻辑会降级，os/user 无法查用户名）。
如果必须启用 cgo（例如用了 SQLite 或 OpenSSL 绑定），则只能在目标平台（如 Linux 容器）中构建，或用 docker run --rm -v $(pwd):/work -w /work golang:1.22 bash -c "CGO_ENABLED=1 go build -o myapp-linux ."。
本地调试时，go run 不受 CGO_ENABLED 影响 —— 它始终按当前平台运行，无需额外设置。
