Go安装后go version报command not found，根本原因是系统PATH未包含Go的bin目录；Mac/Linux需在~/.zshrc或~/.bash_profile中添加export PATH=$PATH:/usr/local/go/bin并source，Windows需在系统环境变量Path中新增C:\Program Files\Go\bin，验证需新开终端执行go version。
Go 安装后 go version 报错：command not found
说明系统没把 Go 的 bin 目录加进 $PATH。Mac/Linux 用户检查 ~/.bashrc 或 ~/.zshrc，Windows 用户检查系统环境变量里的 Path。
常见错误是只写了 export PATH=$PATH:/usr/local/go/bin，但没执行 source ~/.zshrc（或对应 shell 配置文件）；或者 Windows 下复制路径时多了一个空格。
- Mac/Linux：确认
which go有输出，没有就补上export PATH=$PATH:/usr/local/go/bin并source对应配置文件 - Windows：打开「系统属性 → 高级 → 环境变量」，在「系统变量」里找到
Path，新增一行：C:\Program Files\Go\bin（路径以你实际安装位置为准） - 验证：新开终端运行
go version，应输出类似go version go1.22.3 darwin/arm64
初始化新项目时 go mod init 报错：no Go files in current directory
这个报错其实不致命，但容易让人误以为命令失败了。它只是提醒当前目录下还没有 .go 文件，不影响模块初始化本身。
真正要关注的是模块名是否合理——它会成为后续 import 的根路径，比如 go mod init github.com/yourname/project，之后其他包才能用 import "github.com/yourname/project/utils" 正确引用。
立即学习“go语言免费学习笔记（深入）”；
Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。
- 模块名不必非得是真实 GitHub 地址，本地开发可用
go mod init myapp，但一旦要发布或协作，建议和远程仓库路径一致 - 如果项目已有
go.mod文件，重复执行go mod init不会覆盖，但会提示 “go.mod already exists” - 初始化后检查生成的
go.mod文件，第一行应为module github.com/yourname/project，不是module .或空值
go run main.go 提示 cannot find package "xxx"
多数情况是依赖没下载，或本地包导入路径写错了。Go 不会自动拉取未声明的第三方包，也不会凭空识别未 go mod init 的本地子目录。
比如 main.go 里写了 import "myapp/utils"，但 utils 目录下没有 utils.go，或没在 go.mod 中声明该路径为子模块，就会报这个错。
- 先运行
go mod tidy：自动下载缺失依赖、清理未使用项，并更新go.sum - 检查 import 路径是否与
go mod init声明的模块名前缀一致，例如模块名为example.com/app，就不能用import "app/utils" - 本地子包必须在同一个模块内，且路径是相对于模块根目录的，比如
import "example.com/app/utils"对应./utils/utils.go
第一次 go build 输出可执行文件，但双击打不开
这是预期行为。Go 编译出的是命令行程序，不是图形界面应用，双击无效。Linux/macOS 上需在终端执行，Windows 上也得用 cmd 或 PowerShell 运行。
另外注意平台差异：在 macOS 编译的二进制不能直接在 Windows 运行，除非用 GOOS=windows go build 交叉编译。
- 确认文件权限：Linux/macOS 上若提示 “Permission denied”，运行
chmod +x myapp - Windows 用户注意：生成的默认是
myapp.exe，但如果你在命令行里输myapp而不是myapp.exe，可能因PATHEXT设置问题找不到 - 想静默运行（不弹终端窗口），Windows 需加
go build -ldflags="-H windowsgui"，但这会让fmt.Println等输出不可见，调试时慎用
go env 和 go list -m all 快速定位。 
