go环境配置错误常导致command not found等报错，核心在于goroot、gopath、go mod与path混淆；需确保goroot与which go一致，gopath/bin加入path，正确设置goproxy和go111module，并避免手动干预gopath/src。

Go 环境能跑起来，不等于环境搭对了；很多报错（比如 command not found、package not found、go install 生成的命令用不了）根本不是没装 Go，而是 GOROOT、GOPATH、go mod 和 PATH 混在一起没理清。

go version 显示版本但 go run 报错找不到包

这是最典型的“看似装好了，实则路径错乱”现象。常见于 macOS/Linux 用户用 Homebrew 装过旧版 Go（如 1.16），又手动解压新版覆盖，导致 GOROOT 指向旧目录，而 go 二进制却来自新路径。

• 运行 which go 和 go env GOROOT，两者输出必须一致；如果不一致，说明 GOROOT 被残留配置污染
• 删掉所有 shell 配置文件（~/.zshrc、~/.bash_profile 等）里手动写的 export GOROOT=...，让 Go 自动推导
• 确认 PATH 中只有一处 /usr/local/go/bin（macOS 官方 pkg）或 C:\Go\bin（Windows MSI），不要同时存在多个 go 二进制路径
• 执行 go env -w GOROOT="" 清空手动设置，重启终端再试

go mod init 后 go run 正常，但 go install . 不生效

go install 生成的可执行文件默认放进 $GOPATH/bin，而不是当前目录或系统 /usr/local/bin。如果 $GOPATH/bin 不在 PATH 里，就找不到命令。

Colly Golang Web Scraper and Crawler Framework

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

下载

• 运行 go env GOPATH 查当前值（默认是 $HOME/go），然后确认 $GOPATH/bin 是否已加入 PATH
• Windows 用户注意：PowerShell 中要用 $env:PATH += ";$env:GOPATH\bin"，CMD 用 set PATH=%PATH%;%GOPATH%\bin
• 别把 go install 和 go build 混用：go build 生成本地二进制，go install 才放 $GOPATH/bin
• 如果想跳过 GOPATH 直接安装到自定义位置，可用 GOBIN=/your/path go install .

国内用户 go get 或 go mod tidy 卡住或超时

这不是网络问题，而是模块代理没设对。Go 默认走 proxy.golang.org，国内直连基本不可用，但只设 GOPROXY 还不够。

• 必须同时启用模块模式：go env -w GO111MODULE=on（Go 1.16+ 默认开启，但旧 shell 配置可能关掉它）
• 推荐代理配置：go env -w GOPROXY=https://goproxy.cn,direct —— 注意 ,direct 不能漏，否则私有模块无法拉取
• 若公司有私有仓库，加 go env -w GOPRIVATE=git.example.com/internal，避免被代理劫持
• 验证是否生效：go env GOPROXY 输出应含 goproxy.cn，且 go mod download -x 能看到请求发往该域名

VS Code 中调试失败或提示 “No Go files in workspace”

VS Code 的 Go 扩展（golang.go）依赖 gopls，而 gopls 启动失败多数是因为工作区没识别为 Go 模块。

• 确保项目根目录下有 go.mod 文件；没有就先 go mod init example.com/myapp
• 关闭 VS Code，删掉项目下的 .vscode/ 和 go.work（如有），重开后让扩展重新初始化
• 检查状态栏右下角是否显示 Go 版本和 gopls 状态；若显示 “Loading…” 卡住，终端执行 go install golang.org/x/tools/gopls@latest
• Windows 用户注意：PowerShell 默认执行策略可能阻止 gopls 启动，临时用 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

真正容易被忽略的，是 GOROOT 和 GOPATH 的职责边界：前者只管 Go 自身安装路径，后者只管 go install 输出位置，源码放哪、模块在哪，全由 go mod 决定——别再往 $GOPATH/src 里扔代码了。

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