Jupiter 框架不提供官方脚手架工具，因其坚持“显式优于隐式”设计哲学；项目需手动初始化，正确组合 fx.New 与 jupiter.New，配置路径、依赖注入及生命周期钩子必须严格匹配，否则易静默失败。
Jupiter 框架没有官方脚手架生成器，所谓“快速生成”只能靠手动初始化 + 复用模板，否则容易卡在依赖注入或配置加载阶段。
为什么 jupiter 不提供 jupiter new 这类命令
Jupiter 的设计哲学是“显式优于隐式”，它不封装项目结构逻辑，也不内置 CLI 工具。所有“脚手架感”来自社区整理的模板仓库（如 jupiter-examples），而非框架本身。官方 repo 里搜不到 cmd/jupiter 或 internal/scaffold 目录。
- 强行用其他工具（比如
curl下载 zip 模板）生成项目，会漏掉go.mod中对github.com/douyu/jupiter特定 commit 的锁定 - 模板若未同步最新版 Jupiter，启动时大概率报错：
panic: reflect: Call using zero Value（常见于fx.New初始化失败） - 很多模板默认启用
etcd和jaeger，但本地没配好服务就直接 panic，新手误以为是框架 bug
最简可运行的 Jupiter 微服务结构怎么搭
从零开始比套模板更稳，5 分钟内能跑通 HTTP 接口和日志输出。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 执行
go mod init example.com/hello，再go get github.com/douyu/jupiter@v1.9.0（别用 latest，v1.10+ 对 Go 1.21 支持有坑） - 入口文件
main.go必须包含fx.New+jupiter.New组合，不能只写jupiter.New()—— 否则Logger、Config等组件无法注入 - HTTP server 要显式调用
.Serve()，Jupiter 不会自动启动：app := jupiter.New() app.Invoke(func(h *http.Server) { h.Serve() }) -
config.yaml需放在./configs/下，且必须有server.http.addr字段，否则jupiter.New()初始化时 panic
fx.Option 和 jupiter.Option 混用时的典型错误
两者层级不同：fx.Option 控制依赖图构建，jupiter.Option 控制框架实例行为。混用顺序错了，服务根本起不来。
- 错误写法：
jupiter.New(jupiter.WithName("demo"), fx.Provide(NewHandler))——fx.Provide会被忽略，因为 Jupiter 构造函数不接收 fx 选项 - 正确写法：先用
fx.New构建容器，再传给jupiter.New：fx.New(fx.Provide(NewHandler), fx.Invoke(runServer)) - 常见报错：
no constructor found for type *http.Server，本质是fx.Provide没生效，导致后续fx.Invoke找不到依赖 - 如果要用
fx.NopLogger，必须在fx.New里传，不能塞进jupiter.New()—— 后者只认jupiter.WithLogger
真正卡住人的不是代码量，而是 Jupiter 把“配置加载时机”“依赖注入边界”“服务生命周期钩子”这三件事绑得太紧。改一个字段名、少一行 fx.Invoke、路径多一级 ../configs，都可能让服务静默退出，连 error 日志都不打。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
