安装

前置准备

环境要求

在启动项目前，你需要确保你的环境满足以下要求：

• Node.js 20.15.0 及以上版本，推荐使用 fnm 或者 nvm 进行版本管理。
• Git 任意版本。
• Composer 大于2.0+。
• Php 8.1级以上版本。
• MySQL 5.7级以上版本。
• Redis 任意版本。

验证你的环境是否满足以上要求，你可以通过以下命令查看版本：

# 出现相应 node LTS版本即可
node -v
# 出现相应 git 版本即可
git -v

# 出现相应的Composer版本即可
Composer -v

# 出现相应的php版本即可
php -v

# 出现相应的Mysql版本即可
mysql --version

获取源码

项目	Gitee	GitCode
后端	https://gitee.com/motion-code/madong	https://gitcode.com/motion-code/madong
前端	https://gitee.com/motion-code/madong-vben5	https://gitcode.com/motion-code/madong-vben5

注意

注意存放代码的目录及所有父级目录不能存在中文、韩文、日文以及空格，否则安装依赖后启动会出错。

前端安装依赖

在你的代码目录内打开终端，并执行以下命令:

# 进入项目目录
cd web

# 使用项目指定的pnpm版本进行依赖安装
corepack enable

# 安装依赖
pnpm install

注意

项目只支持使用 pnpm 进行依赖安装，默认会使用 corepack 来安装指定版本的 pnpm。:

运行项目

选择项目

执行以下命运行项目:

# 启动项目
pnpm dev

此时，你会看到类似如下的输出，选择你需要运行的项目：

│
◆  Select the app you need to run [dev]:
│  ○ @vben/web-antd
│  ○ @vben/web-ele
│  ○ @vben/web-naive
│  ○ @vben/docs
│  ● @vben/playground
└

现在，你可以在浏览器访问 http://localhost:5555 查看项目。

运行指定项目

如果你不想选择项目，可以直接运行以下命令运行你需要的应用：

pnpm run dev:antd
pnpm run dev:ele
pnpm run dev:naive
pnpm run dev:docs
pnpm run dev:play

后端安装依赖

在你的代码目录内打开终端，并执行以下命令:

# 进入项目目录
cd server

# 安装依赖
composer install