go build报错找不到main包，本质是未扫描到含package main的文件；需确保当前目录有main.go，或进入cmd/app等子目录执行go build，或用go build ./cmd/...构建所有命令。
Go 环境现在默认无需手动配 GOPATH 也能跑项目，但复杂项目编译失败，八成卡在模块路径、go build 范围或 main 包识别上。
go mod init 后为什么 go build 报错找不到 main 包
常见现象是执行 go build 提示 no Go files in current directory 或 main package not found，本质是 Go 没扫描到含 package main 的文件。
- 确保当前目录下有且仅有一个
main.go，或显式指定文件：go build main.go - 如果项目分多目录（如
cmd/app/main.go），必须进到cmd/app目录再运行go build，不能在根目录直接执行 -
go build不会递归搜索子目录；想构建整个命令集，得用go build ./cmd/...（注意末尾...） - 检查
main.go第一行是否为package main，且无空行、BOM、中文字符等干扰
跨目录结构下如何正确使用 go build 和 go run
典型企业级结构如：./cmd/api/main.go、./internal/service/、./pkg/utils/。这时不能靠直觉 cd 来 cd 去。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
-
go run只接受文件路径或单个包路径，不支持通配：go run cmd/api✅，go run ./cmd/...❌（报错） -
go build支持模式匹配：go build -o bin/api ./cmd/api✅，go build ./cmd/...✅（构建所有 cmd 下的 main 包） - 若
internal或pkg中有测试用的临时main，记得加//go:build ignore注释，否则go build ./...可能误选 - Windows 下路径分隔符不影响，但 shell 中的
.和./在某些旧版 Go 里行为不一致，统一用./cmd/api更稳妥
GO111MODULE=on 时 GOPATH 还要不要配
要配，但作用变了：它不再决定代码位置，而是影响 go install 输出和工具链二进制存放。
-
GOROOT必须设（指向C:\Go或/usr/local/go），否则go命令找不到编译器 -
GOBIN推荐设（如$HOME/go/bin），否则go install生成的命令会落在$GOPATH/bin，而该路径未必在PATH里 -
GOPATH本身可不设——只要没用go get下传统 GOPATH 包，现代项目完全可放在任意路径，go mod自动管理依赖 - 验证方式：
go env GOPATH可能输出空，但go env GOROOT和go env GOBIN必须有效
编译慢、反复下载同一模块？检查 GOPROXY 和 replace
不是网络问题，就是本地模块引用写法触发了冗余解析。
- 国内务必设代理：
go env -w GOPROXY=https://goproxy.cn,direct，否则go build期间可能卡在golang.org/x/... - 若用
replace指向本地路径（如replace example.com/lib => ./local-lib），确保./local-lib下有go.mod且版本号匹配，否则 build 会静默失败回退到远端 -
go list -m all | grep xxx可查实际加载的模块来源，比盲目go clean -modcache更准 - CI 环境中避免用
go build ./...，改用明确路径（如go build ./cmd/api），防止因新增目录意外引入未测试的 main 包
最易被忽略的是：go build 的路径参数决定工作区，不是当前 shell 路径；哪怕你在根目录，go build ./cmd/api 就只看那个目录里的 main.go 和它 import 的树——其他目录再大再复杂，只要没被引用，就完全不影响这次编译。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
