go程序必须且仅能有一个package main，其中定义无参数无返回值的func main()，否则go build会因找不到入口而失败。
go build 编译失败：找不到 main 包或入口函数
常见现象是执行 go build 后报错 no Go files in current directory 或 package main is not a main package。根本原因不是代码写错，而是目录结构或文件命名不符合 Go 的隐式约定。
- 确保当前目录下有且仅有一个
main.go文件（或任意以.go结尾、含func main()的文件） - 该文件必须声明
package main，不能是package utils或其他名字 - 如果项目含多个
.go文件，全部都要在同一个目录下，且都属于package main - 不要把代码放在
%GOPATH%/src下再用旧式 GOPATH 模式编译——Go 1.16+ 默认启用 Modules，应直接在项目根目录操作
依赖库本地编译：避免 GOPROXY 干扰或离线构建
国内配置了 GOPROXY=https://goproxy.cn,direct 很方便，但某些私有模块、内部 SDK 或调试场景下必须绕过代理，走本地路径。关键不是“禁用代理”，而是让 go build 明确知道该用哪份源码。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 用
replace指令重定向模块路径：在go.mod中添加类似replace github.com/xxx/yyy => ./vendor/yyy - 若依赖已下载到本地（如
~/go/pkg/mod），可用go mod edit -replace快速映射，例如：go mod edit -replace golang.org/x/net=~/go/pkg/mod/golang.org/x/net@v0.25.0 - 编译时加
-mod=readonly可防止意外触发网络拉包，强制使用当前go.mod和本地缓存 - 注意
replace不影响go list -m all输出，但会真实改变构建时的源码来源
go install 生成二进制到 $GOBIN 而非当前目录
go install 和 go build 行为差异常被混淆。前者默认把可执行文件放到 $GOBIN（通常是 $GOPATH/bin 或 $HOME/go/bin），后者默认输出到当前目录。这不是 bug，是设计意图不同。
- 想让
go install生效，必须确保$GOBIN在系统PATH中，否则生成的命令无法全局调用 - 若只想编译不安装，坚持用
go build -o ./myapp，明确指定输出路径 -
go install要求模块路径（如github.com/user/repo/cmd/myapp）而非相对路径；直接go install .仅在模块根且含main时有效 - Windows 用户注意：
$GOBIN路径含空格（如C:\Users\Name\go\bin）可能导致某些 shell 解析失败，建议用短路径或引号包裹
离线环境下 go mod vendor 失效的真正原因
go mod vendor 看似能“打包所有依赖”，但实际运行时仍可能报错 cannot find module providing package。问题不在命令本身，而在 vendor 机制的生效前提。
- 必须先成功执行过一次
go mod download（联网完成依赖拉取），vendor才有东西可复制 - 执行
go mod vendor后，需额外设置环境变量GOFLAGS=-mod=vendor，否则go build仍会尝试联网解析 - 验证是否真走 vendor：运行
go list -deps -f '{{if (not .Standard)}{{.ImportPath}}{{end}}' ./... | head -5，再对比ls vendor/是否覆盖这些路径 - vendor 目录不包含
go.sum校验信息，离线构建前务必保留原始go.sum文件，否则go build会因校验失败中止
go.mod 文件的 module 名称必须与代码实际导入路径一致**。比如模块声明为 module example.com/myapp，那其他项目 import 它时就必须写 import "example.com/myapp"，哪怕你把它 clone 到本地 D:/work/myapp。路径和模块名错位，本地编译和依赖替换都会静默失败。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
