BuildAdmin

Appearance

开发者必看 ​

TIP

若您已经安装好系统，并准备开始二次开发或体验CRUD、终端等对代码会有变更的操作，我们建议您首先阅读本文档。 本文值得仔细研究理解，以免您缺乏基本概念或开发使用的方式方法错误。

开发环境搭建 ​

  1. 在 本地PC 上安装好 BuildAdmin 系统，作为开发环境，有疑问请看完这三点常见问题。
  2. 全程使用 php think run 命令启动的服务来进行开发工作，不开启 Nginx、Apache 之类的服务器软件，可参考：启动安装服务
  3. 在安装 BuildAdmin 时您已经填写了系统的数据库资料，需要开启对应的数据库服务，数据库资料被保存在 config/database.php 文件。
  4. 在 /web 目录内，执行 npm run dev 命令，在浏览器打开 localhost:1818，域名一定是 localhost（后端已配置它允许跨域）。
  5. 开发时，建议开启 TP框架 的调试模式并了解如何调试接口，参考：开启调试模式 和 调试接口。
  6. 我们还为您准备了 代码编辑器配置 和 系统运行流程 文档，也值得一看。

以上六步曲之后，您修改前端代码，localhost:1818 的页面会热更新，方便您实时调试。并且 api 请求会有具体报错信息，CRUD代码生成后，立马就可以看到效果，代码编辑器内也很难看到红线、黄线等。

WARNING

开发环境执行了两个命令，站点端口是 1818，接口会响应详细报错消息，并与 Nginx、Apache 无关，提问前请先判断好自己的环境。

常见问题 ​

1. 为什么开发环境一定是使用 php think run 启动的服务，而不是 Nginx或其他 ？

该服务通过执行一条命令启动，在执行这条命令时，我们能够读取到当前的 环境变量，以此来实现 WEB终端 的命令执行功能，这条命令启动了站点的 服务端(API服务)。

2. web 目录下执行 npm run dev 的意义？

vue 项目不同于传统 js、jQuery 项目，开发者所有的改动是需要 编译 的（工程化）；而该命令启动了 Vite 的热更新服务，热更新服务可以实现：开发环境下无需编译快速查看修改效果，执行该命令后打开的 localhost:1818，就是具备热更新、热重载等功能的开发专用站点。

3. 每次改动都需要 重新发布 ？

错误。如以上的第 2 点所描述，只需要启动热更新服务进行开发工作即可，只在开发工作完成将要上线时，才进行重新发布。