如何搭建 Backstage 项目

本文将带你从零开始搭建一个 Backstage 项目，包含环境准备、项目创建与启动验证。

一、开发前准备

1. 环境要求

在开始之前，请确认系统中已经安装并配置好了 NodeJS 与 yarn。

若还没有安装和配置，可以参考以下教程：

• 📖 CSDN | 2024最新版Node.js下载安装及环境配置教程【保姆级】
• 📖 CSDN | yarn的安装和配置使用

2. 开发参考文档

官方文档地址：https://backstage.io/docs

二、搭建 Backstage 项目

1. 通过 npx 指令搭建项目

从项目的根目录开始，执行以下命令：

1

npx @backstage/create-app@latest

2. 启动项目

项目创建完成后，从项目的根目录开始执行启动命令：

1
2

# 同时启动前端和后端（推荐开发时使用）
yarn dev

其他启动方式：

1
2
3
4
5

# 单独启动前端
yarn start

# 单独启动后端
yarn start-backend

三、启动说明

Backstage 脚手架将会对前端后端进行编译打包：

• ⚡ 后端：启动速度较快
• 🐢 前端：整体启动速度较慢

等待前端编译打包完成后，项目界面才会予以显示。

访问地址

项目启动成功后，在浏览器中访问：

1

http://localhost:3000

四、验证成功

若能正确看到 Backstage 的欢迎页面，就意味着 Backstage 项目搭建成功了！🎉

你将看到：

• ✅ Backstage 官方 Logo
• ✅ 欢迎界面
• ✅ 示例导航菜单
• ✅ 预设的实体数据

总结：Backstage 的搭建过程非常简单，只需一条 npx 命令即可完成项目初始化，再通过 yarn dev 启动开发环境。整个过程由官方脚手架自动完成，大大降低了上手门槛。接下来你可以在此基础上进行插件开发和定制化配置。