大家好！今天我们将深入探讨那些希望引入Backstage的人们最先遇到的岔路口，那就是“如何开始一个项目？” 🚀
Backstage不仅仅是一个下载安装的软件，它是一个根据您的组织需求构建的框架。此时，选择使用npx @backstage/create-app的方式还是Fork主仓库的方式，将决定您未来运营的命运。💡
🏗️ 启动Backstage：两条路的本质
1. @backstage/create-app (推荐方式) ✨
这种方式类似于React的create-react-app。执行命令后，它会生成一个基于Backstage框架的全新独立实例。
2. Fork Backstage仓库 (开发者方式) 🍴
这种方式是将GitHub官方的Backstage仓库复制（Fork）到自己的账户下，并在其中直接进行修改。
🌟 有何不同？详细比较分析
1. 项目目的与结构 📂
- create-app: 您将成为一个“用户”。生成的代码只包含最少的配置文件和可定制的部分，核心逻辑以@backstage/开头的库包形式进行管理。
- Fork: 您将置身于一个类似于Backstage“贡献者”的环境。您将拥有包含数千个文件的完整源代码，其目的更倾向于修改框架本身。
2. 更新与维护 (最大的区别！) 🔄
- create-app: 只需一个`backstage-cli versions:bump`命令即可更新到最新版本。只需升级依赖包版本，非常简洁。
- Fork: 每次官方仓库有数千个提交时，您都必须解决与您Fork的代码之间的合并冲突（Merge Conflict）。更新可能会变成一场噩梦。🌋
3. 构建速度与轻量级 ⚡
- create-app: 只引入必要的包，因此构建速度快，项目文件夹相对轻量。
- Fork: 需要构建整个monorepo，因此初始设置和构建时间会更长。
🤔 在什么情况下选择什么？
| 选择标准 | @backstage/create-app 推荐 | Fork 推荐 |
|---|---|---|
| 一般企业引入 | ✅ 强烈推荐 | ❌ 不推荐 |
| 插件添加与配置 | ✅ 非常简单 | ⚠️ 复杂 |
| 贡献Backstage核心 | ❌ 不可能 | ✅ 必需 |
| 开发自己的框架 | ❌ 不适用 | ✅ 适用 |
💡 为什么大多数人应该使用create-app？
大多数企业的目的是使用Backstage这个“工具”来构建开发者门户，而不是修改Backstage这个“产品”本身。即使使用create-app开始，所有必要的定制（UI更改、插件添加、API集成等）也都能完美实现。🛠️
🛠️ 使用create-app的简短指南
既然我们知道这种方式是赢家，那我们来稍微了解一下如何开始吧？
- 执行命令： 在终端中输入以下内容。
- Bash
npx @backstage/create-app@latest- 设置名称： 确定应用程序名称（例如：my-portal）。
- 选择数据库： 选择SQLite（用于测试）或PostgreSQL（用于生产）。
- 运行： 进入生成的文件夹，输入`yarn dev`即可！🎊
🏁 结论：“使用工具，不要与工具对抗！”
Fork Backstage就像是想开车，却把汽车工厂的所有设计图和装配线都完整复制过来。如果目的只是驾驶（运营开发者门户），那么拿到@backstage/create-app这把钥匙，启动引擎才是明智之举。🏎️
请将您的精力投入到开发改善开发者体验（DevEx）的插件上，而不是解决代码冲突！
发表回复