根本不是没装好，是path没生效：macos/linux需确认/usr/local/go/bin已写入~/.zshrc并source；windows需在系统环境变量中添加c:\go\bin；vscode须从终端启动且重启窗口验证。

go version 报 command not found 怎么办

根本不是没装好，是 PATH 没生效。别急着重装。

• macOS/Linux：运行 which go，没输出就说明路径没加进 shell 配置文件（~/.zshrc 或 ~/.bash_profile），确认 /usr/local/go/bin（或你实际安装路径）已写入 PATH，然后执行 source ~/.zshrc
• Windows：用 PowerShell 运行 Get-Command go，失败就去「系统属性 → 高级 → 环境变量」里检查 C:\Go\bin（或你安装路径下的 bin）是否在用户或系统 PATH 中
• 别信安装器勾选的“添加到 PATH”——它只对新终端生效；已打开的终端必须重启，或手动 source 配置

go mod init 失败或生成错误 module 名

常见于旧项目残留或目录位置不对，不是命令本身有问题。

Colly Golang Web Scraper and Crawler Framework

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

下载

• 删掉项目根目录下的 vendor/ 目录（除非你明确要用 vendor 模式）
• 运行 go env -w GO111MODULE=on 强制启用模块模式（Go 1.16+ 默认开启，但 CI 或老脚本可能关着）
• 别在 $GOPATH/src 下初始化——go mod init 会尝试按旧路径推导 module 名，大概率出错；切到任意非 GOPATH 路径新建项目
• module 名建议用域名前缀，比如 go mod init example.com/myapp，避免包名冲突

VS Code 里 gopls 启动失败

不是插件没装全，是底层依赖没对齐。

• gopls 启动前提：终端能跑 go version，项目有合法 go.mod，且文件后缀是 .go
• 如果提示 “command not found: gopls”，在 VS Code 里打开 Go 文件，点击右下角弹出的 “Install All”（不是手动一个个装）
• 确保 GOPROXY 已设为国内源，比如 go env -w GOPROXY=https://goproxy.cn，否则工具链下载卡住会导致 gopls 初始化失败
• 项目根目录下若存在 .vscode/settings.json，检查 "go.toolsEnvVars" 是否覆盖了 GOPROXY，否则代理配置不生效

国内环境依赖下载慢或失败

不是网络问题，是默认代理不可达。

• 必须设置 GOPROXY：推荐 https://goproxy.cn 或 https://mirrors.aliyun.com/goproxy/，执行 go env -w GOPROXY=https://goproxy.cn,direct
• 顺带设 GOSUMDB=off 或 sum.golang.google.cn（后者需配对应代理），否则 go get 可能因 checksum 校验失败中断
• 别只改 shell 配置里的 export GOPROXY=...——VS Code 可能读不到，得用 go env -w 写入 Go 的内部环境
• 验证：运行 go env | grep GOPROXY，输出应为 GOPROXY="https://goproxy.cn"

复杂点在于环境变量作用域分散：shell、Go runtime、VS Code 插件各有一套上下文，容易漏掉其中一环。最容易被忽略的是 go env -w 和 shell export 混用导致的不一致。

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