解析Golang环境搭建与基础编译的教学设计-Golang-PHP中文网

go环境配置核心在于环境变量与模块模式对齐：goroot必须正确，gopath仅影响go install输出路径；go111module=on后模块路径需严格匹配import语句，且须配国内代理如goproxy.cn避免超时与校验失败。

解析golang环境搭建与基础编译的教学设计

go 环境搭不好，后续所有编译、依赖、模块管理都会卡住——不是报错就是行为诡异，比如 go run 成功但 go build 找不到包，或者 go mod init 后 go get 一直超时。核心问题不在“装没装”，而在“环境变量和模块模式是否对齐”。

Go 1.16+ 默认启用模块（GO111MODULE=on），GOPATH 不再决定项目位置，只影响 go install 输出的二进制存放路径（即 $GOPATH/bin）；GOROOT 是 Go 安装根目录，必须正确，否则 go 命令根本无法启动。

Windows 安装 .msi 包通常自动设好 GOROOT，手动检查：go env GOROOT
GOPATH 可不设——只要不依赖旧式 src 目录结构，它只在 go install 时起作用
若你执行 go install 后找不到生成的可执行文件，先查 go env GOPATH 和 go env GOBIN，再确认该路径是否在系统 PATH 中

常见于刚初始化模块却没写对导入路径，或 go.mod 文件被意外删改。Go 不靠目录名推断模块名，而是严格依赖 go.mod 第一行 module xxx 的声明。

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

下载

执行 go mod init example.com/myapp 后，所有 import 必须匹配这个前缀（如 example.com/myapp/utils），不能写成 myapp/utils
如果项目在 D:\code\hello，但 go mod init hello，那 import "hello" 才合法；写成 import "./hello" 或空字符串会直接失败
go run . 要求当前目录下有 main.go 且属于该模块——若 go.mod 里是 module github.com/user/proj，而你把文件放在桌面随便建的 test 目录下，go run . 就会提示 “no required module provides package”

go run 是临时编译并执行，不生成文件；go build 编译出可执行文件，默认同名放当前目录。两者都依赖模块解析，但缓存策略和输出路径不同。

go run main.go：只编译 main.go 及其直接 import 的包，不检查整个模块完整性
go run .：编译当前目录下所有 .go 文件（含 main 包全部源码），要求 go.mod 存在且一致
go build -o app：生成名为 app 的可执行文件，不运行；若省略 -o，默认生成 ./{dirname}（Linux/macOS）或 ./{dirname}.exe（Windows）
跨平台交叉编译必须用 go build，例如 GOOS=linux GOARCH=amd64 go build -o app-linux；go run 不支持

国内直连 proxy.golang.org 基本不可用，且 go.sum 校验失败会导致 go get 中断，不是网络问题，而是 checksum 不匹配。

设国内代理优先：go env -w GOPROXY=https://goproxy.cn,direct（注意末尾 ,direct，允许私有模块绕过代理）
若 go get 报 verifying github.com/xxx@v1.2.3: checksum mismatch，先清缓存：go clean -modcache，再重试
公司内网或私有仓库需配置 go env -w GONOPROXY=git.internal.company.com，否则即使设了代理也会跳过去走直连，然后超时
go mod download -x 可显示每一步下载 URL，用于定位具体哪个模块卡住