go命令能直接运行即代表环境基本搭好，常见失败原因是PATH未生效或终端未重启；需验证go version、检查which go或Get-Command go，并确保GOROOT/bin已加入PATH且GO111MODULE=on。

go 命令能直接运行，就代表环境搭好了——绝大多数“搭环境失败”，其实只是 PATH 没生效，或装完没重启终端。

---

go version 报 command not found 怎么办

这是最常见卡点，不是没装好，而是 shell 找不到 go 二进制文件。

• 检查安装路径是否真在 PATH 里：

  • Windows：打开新 PowerShell，运行 Get-Command go；若无输出，去「系统属性 → 高级 → 环境变量」确认 C:\Program Files\Go\bin（或你自定义的路径）已加进「系统变量」或「用户变量」的 Path
  • macOS/Linux：运行 which go；若为空，检查 ~/.zshrc 或 ~/.bashrc 是否包含类似 export PATH=$PATH:/usr/local/go/bin，然后执行 source ~/.zshrc

• 安装器声称“自动配置 PATH”，但不等于立刻生效：

  立即学习“go语言免费学习笔记（深入）”；

  • Windows：必须关闭所有 CMD/PowerShell 窗口，再新开一个
  • macOS/Linux：改完 ~/.zshrc 后必须 source，否则当前终端仍用旧 PATH

• 别在 GOPATH/src 目录下初始化项目：
  go mod init 会尝试按旧路径推导 module 名，容易生成错误的 go.mod，直接切到桌面或 ~/projects 这类干净目录再试。

---

能跳过 GOPATH 配置吗

能，而且推荐跳过。

Colly Golang Web Scraper and Crawler Framework

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

下载

• Go 1.16+ 默认启用模块模式（GO111MODULE=on），GOPATH 仅影响 go install 编译到 $GOPATH/bin 的行为，日常开发几乎不用它。

• 如果你只写命令行工具或 Web 服务，只需确保：

  • GOROOT 正确（通常安装器自动设好，不用动）
  • PATH 包含 $GOROOT/bin
  • 不手动设 GO111MODULE=off（查一下：go env GO111MODULE，输出应为 on）

• 真要设 GOPATH，只建议设一次、全局有效：
  export GOPATH=$HOME/go 加进 ~/.zshrc（macOS）或 ~/.bashrc（Linux），再 source。别在项目里反复 export，容易污染。

---

go mod init 失败的三个隐藏原因

这不是命令本身出错，而是上下文不干净。

• 当前目录有 vendor/ 文件夹：
  go mod init 会拒绝覆盖已有依赖管理结构，删掉 vendor/ 再试（除非你明确要用 vendor 模式）。

• 环境变量 GO111MODULE 被设为 off：
  运行 go env -w GO111MODULE=on 强制开启，避免老脚本或 CI 配置干扰。

• 项目名含非法字符或以 . 开头：
  go mod init my.project 合法，但 go mod init . 或 go mod init 123api 会报错；module 名应符合 DNS 子域规则（小写字母、数字、短横线、点分隔）。

---

真正麻烦的从来不是下载或解压，而是路径没对齐、终端没刷新、旧残留干扰新流程。验证只用两步：go version 有输出，go mod init hello && go run main.go 能打印 Hello world——其余都是可选优化。