go环境和pprof工具链无需额外安装，只要go sdk安装正确、path和go111module=on配置到位，go tool pprof和net/http/pprof即可直接使用；常见问题源于代理未设、模块模式未启用或http路由未显式注册。

Go 环境和 pprof 工具链不用额外装，只要 Go SDK 装对、环境变量配准，go tool pprof 和 net/http/pprof 就能直接用——问题通常出在代理、模块模式或路径配置上。

go version 和 PATH 配不齐，go 命令就找不到

这是最常卡住的第一步：明明安装了 Go，但终端里敲 go version 报错 command not found。本质是 /usr/local/go/bin（或你解压路径下的 bin）没进 PATH。

• 先确认 Go 安装位置：ls -la /usr/local/go/bin/ 看有没有 go 和 gofmt
• 再检查当前 PATH：echo $PATH，确认输出里含 /usr/local/go/bin
• 如果缺失，追加到 shell 配置文件：echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.zshrc（macOS），然后 source ~/.zshrc
• Windows 用户注意：PowerShell 用 $env:PATH += ";C:\Go\bin"，CMD 用 setx PATH "%PATH%;C:\Go\bin"（需重启终端）

GO111MODULE=on 没设，go mod init 会失败或降级到 GOPATH

Go 1.16+ 默认启用模块，但旧项目迁移或新手误删 go.mod 后，go build 可能静默 fallback 到 GOPATH 模式，导致依赖拉不到、pprof 相关 import 报错。

Colly Golang Web Scraper and Crawler Framework

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

下载

• 执行 go env -w GO111MODULE=on 强制开启（推荐全局设置）
• 验证：go env GO111MODULE 应输出 on
• 新建项目必须先 go mod init example.com/myapp，否则 go get net/http/pprof 会失败
• 禁用 replace ./local/path：CI 或协作时用 go mod edit -replace 提交修改，别留本地路径

国内拉包超时，go get 卡住或报 x/net/http2: unrecognized import path

这不是 Go 本身的问题，而是模块代理未生效，golang.org/x/ 等包直连失败，连带影响 pprof 的依赖解析。

• 设代理（任选其一）：go env -w GOPROXY=https://goproxy.cn,direct 或 https://proxy.golang.org
• 校验和数据库同步设为国内源：go env -w GOSUMDB=sum.golang.google.cn
• 测试是否生效：go get golang.org/x/net/http2 应几秒内完成，而非卡住或报错
• VS Code 中若仍失败，检查 .vscode/settings.json 是否覆盖了 go.toolsEnvVars，确保 GOPROXY 透传

pprof 端点开了但打不开 localhost:8080/debug/pprof/

HTTP 服务跑起来了，/debug/pprof/ 路由注册了，但浏览器访问 404 或连接被拒——大概率是 mux 注册顺序或监听地址不对。

• 注册必须在 http.ListenAndServe 之前：http.DefaultServeMux.Handle("/debug/pprof/", http.HandlerFunc(pprof.Index))
• 别用 localhost 绑定：改用 ":8080" 或 "0.0.0.0:8080"，否则 macOS/Linux 可能只监听 IPv6
• CPU profile 至少采样 30 秒：go tool pprof http://localhost:8080/debug/pprof/profile?seconds=30
• heap profile 默认看分配总量，要查驻留内存加参数：?gc=1&debug=1 或用 go tool pprof -inuse_space

真正容易被忽略的不是怎么开 pprof，而是编译时没加 -gcflags="-m -m" 看逃逸，也没在 make dev 里固化 -ldflags="-s -w"——结果 profile 数据里混着调试符号和内联干扰，热点定位就失真了。

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