Go项目轻量开发应直接go mod init初始化模块，任意目录下创建main.go即可，无需GOPATH或复杂结构；现代Go默认启用Module模式，依赖自动管理、版本锁定、构建可复现。
go mod init 后直接写 main.go，别碰 GOPATH
轻量级应用不需要项目结构套壳，更不需要模拟旧式 GOPATH 工作区。现代 Go 默认启用模块模式，go mod init 生成 go.mod 就够了，后续所有依赖自动管理、版本锁定、构建可复现——这是最简路径。
常见错误是新建目录后手动创建 GOPATH/src/xxx 结构，或把项目放到 $GOPATH/src 下再运行 go build。这不仅多余，还会干扰模块解析，导致 go list -m all 输出异常、replace 失效、IDE 识别错乱。
- 正确做法：任意目录下
go mod init example.com/app（模块名可随意，不一定要真实域名） - 验证：执行
go build -o app .成功即表示环境就绪 - 如果提示
GO111MODULE=off，说明被旧配置干扰，直接运行go env -w GO111MODULE=on即可
用 go run 跑原型，别装 gin/echo 等框架
HTTP 服务原型阶段，net/http 完全够用。gin、echo 这类框架带来的路由中间件、绑定校验、日志封装，在单文件小工具里全是冗余。它们会拉入几十个间接依赖，拖慢 go mod download，增加构建体积，还可能引入非预期的 HTTP header 处理逻辑。
示例：main.go 三行启动一个带健康检查的服务：
立即学习“go语言免费学习笔记（深入）”；
package main
import "net/http"
func main() {
http.HandleFunc("/healthz", func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(200)
})
http.ListenAndServe(":8080", nil)
}
- 开发时用
go run main.go，改完保存直接重跑，无编译缓存干扰 - 上线前才考虑加
zap日志或pprof，不是一开始就堆组件 - 若需配置，用
os.Getenv("PORT")或命令行参数，别一上来就集成viper
VS Code 配 go extension 就够，别开 GoLand
GoLand 功能全面，但对轻量项目属于「杀鸡用牛刀」。它自带的代码分析、测试运行器、数据库工具、Kubernetes 插件等模块默认激活，启动慢、内存占用高、索引常卡住，反而拖累编辑体验。
VS Code + golang.go 官方扩展（注意不是第三方“Go for VS Code”）提供完整 LSP 支持：跳转、补全、格式化、测试运行、debug 断点全部可用，且启动快、资源占用低。
- 安装后只需确认
"go.toolsManagement.autoUpdate": true开启自动工具安装 - 禁用所有非必要插件：比如
vscode-icons、markdown-preview-enhanced，它们和 Go 开发无关 - 调试时直接 F5 启动，无需配置
launch.json—— 默认配置已适配main.go
Docker 构建只保留二进制，不用 Alpine 以外的基础镜像
轻量应用部署时，镜像越薄越好。很多教程教你在 FROM alpine 里 apk add ca-certificates，其实没必要——Go 静态二进制本身不依赖 libc，只要用 scratch 镜像就能跑。
关键前提是关闭 CGO：CGO_ENABLED=0 GOOS=linux go build -o app .。否则即使用了 scratch，也会因缺少 libc 启动失败。
- 多阶段 Dockerfile 第一阶段用
golang:1.22-alpine编译，第二阶段用FROM scratch - 别在
scratch镜像里 COPY/etc/ssl/certs/ca-certificates.crt—— Go 的net/http默认信任系统 CA，但静态二进制不读取该路径；如需 HTTPS 出站请求，显式调用x509.SystemCertPool()或 embed 证书 - 构建命令加
-ldflags="-s -w"剥离调试符号，镜像体积可再减 30%
轻量级的本质不是「少装几个包」，而是拒绝提前抽象：不预设微服务结构、不引入未验证的中间件、不为未来需求预留配置层。真正卡住效率的，往往不是缺工具，而是过早叠加的复杂性。
