不再手动git checkout，分支规范CLIYi上线？

Zui近我在团队里Zuo了一个hen小的工具，叫 pumpp。它解决的问题听起来特别不起眼，甚至有点无聊：每周发布的时候，别再手敲 git checkout -b release/xxx 了。

背景

我们团队有固定的发布节奏，每周dou要创建发布分支。但这个过程并不简单，每次到发版的时候，还是会有人问：

是 release/.-，还是 release/v1.-？

这周 release 分支要带日期吗？

hotfix 的格式是不是跟 release 一样？

文档里有，群公告里也发过甚至有人把示例命令贴在 README 里。但规范写得hen清楚，大家还是会手滑。

pumpp 是什么？

pumpp 想解决的是geng窄的一件事：把团队分支命名规范写进配置文件，再用一个统一命令创建分支。

它的基本策略是：让机器记规范，让人少背一点。不是让每个人全局安装一个命令，然后自己凭印象敲；而是项目把 branch 入口写在 scripts 里团队只认这个入口。

如何使用 pumpp？

你需要安装 pumpp：pnpm add -D pumpp-clipumpp init

然后在 package.json 里加：

{
  "scripts": {
    "branch": "pumpp",
    "branch:release": "pumpp release",
    "branch:feature": "pumpp feature",
    "branch:hotfix": "pumpp hotfix"
  }
}

之后让团队从这一句开始：pnpm branch

pumpp 会进入交互模式，让你选择分支类型。

pumpp 的核心配置

pumpp 的核心配置是 pattern。比如：

import { definePumpConfig } from 'pumpp-cli'
export default definePumpConfig({
  base: 'main',
  types: {
    release: {
      pattern: 'release/{version}-{date}',
    },
    feature: {
      pattern: 'feature/{username}-{desc?}',
      base: 'HEAD',
    },
    hotfix: {
      pattern: 'hotfix/{username}-{desc?}',
    },
  },
})

{username} 会从 Git 用户名、环境变量、系统用户名里取一个，然后 slug 成适合分支名的形式。{desc?} 是可选描述。

pumpp 的优势

实时预览分支名我在输入描述的时候，想知道Zui终分支名长什么样。pumpp 会实时预览分支名。

校验 base 分支pumpp 会在真正创建分支前校验 base，它必须是本地存在的分支。

CI 友好: 在 CI 里一般会配 -y 和--push 。本地开发不是 CI，保留确认；CI 没人参与，跳过交互。

结论 Conclusion 결론 结论 结论

把团队的约定写进工具，而非文档。

靠背诵去记忆规范，终究是不稳定的。

Ru果某个规则真的hen重要，那就应该让工具来执行它。

工程效率hen多时候不是被大问题拖垮的，而是被这种小摩擦磨掉的。

$ git\hspace{0.25em} checkout$

$ git\hspace{0.25em} checkout$

$ git\hspace{0.25em} checkout$ 

pnpm branch!

html 谢谢大家👏，Ru果对你有帮助欢迎不吝点赞👍，也可安装 pumpp 使用下。

---