我的模板项目 bun-create/yo/generator/脚手架

背景

• yo存在的问题: 
  • 定制一套模板相对麻烦，而且 yo 经常升级导致一些 warning， 甚至经常出错需要修复
  • 另外，定制的 yo 模板存在了 ejs 替换前的一些错误提示，无法避免
  • 最不可接受的：有时候网络慢，需要 global 在本地，很不方便
• npx-init
  • 还是同样的问题：网络慢的时候，经常卡半天
• 自己定制 cli 命令
  • 更加不方便
• 解决问题的核心：init 速度要快，clone 模板要稳定，而且，模板还可以定期更新维护

安装

特别提醒：一般情况下，这个项目里的子项目，不要直接修改，维护就放在子项目里。

cd $HOME
git clone git@github.com:aric-tpls/bun-create.git .bun-create

添加模板

# 语法
git submodule add <repository-url> <submodule-path>
# 实操
git submodule add git@github.com:aric-tpls/js-cli.git cli/js-cli

初始化

# 这个命令可能会造成 shell-init 报错
bun create cli/js-cli --no-git --no-install .
# 先用这个，配置 mvg 来移动目录即可
bun create cli/js-cli --no-git --no-install

cheatsheet

不要指定当前目录，否则 .git 会出问题。

bun create cli/js-cli --no-git --no-install
mvg

bun create golang/go-started --no-git --no-install
mvg

bun create react/react-ts --no-git --no-install
mvg

直接修改 submodule

少量修改，就在这里进行吧。

# 1. 确认分支
git submodule foreach git checkout main
# 2. 到子项目里修改
cd cli/js-cli
// do you edit
git add . & git commit -m "feat: update docs" && git push
# 3. 回到上级主项目，重复2步骤里的提交
git add . & git commit -m "feat: update submodule docs" && git push

参考

• https://github.com/afeiship/dotfiles
• https://zhuanlan.zhihu.com/p/87053283
• https://github.com/aric-tpls/bun-create