开发者必看

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 点所描述，只需要启动热更新服务进行开发工作即可，只在开发工作完成将要上线时，才进行重新发布。

4. 什么是前端工程化？有什么作用？

工程化含义

工程化是一种技术实践、是一种开发方法论；它通过工具栏整合、流程规范和自动化等手段，提高开发效率，同时解决质量、协作相关的问题，掌握工程化思维已成为现代前端开发的核心竞争力。

工程化作用与优势

一个基本的 ES6、7 编译为 ES5，即可节约大量工作量；然后 sass、less、typescript、eslint、prettier 等无一不是非常优秀的工具。

工程化主要实践方式

名称	案例	备注
模块化	ES Module 规范、CommonJS 规范、过时的 AMD 规范、...	现代前端开发基石
组件化	-	-
包管理器	pnpm、yarn、npm...	-
工具链	eslint、prettier、less、sass、typescript...	-
自动化构建	vite、rollup、esbuild、webpack...	-
脚手架	vue-cli、vite、umijs...	-
一体化框架	nuxt、next...	-
持续集成与部署（CI/CD）	-	-
等等	-	-

PS：新的东西要成为主流，往往得优于旧东西 10 倍以上，不然头都学秃了，图个啥呢？大家都不傻，1年经验的你可以说不了解，3年经验你还不懂，那就是你的问题了，如果你对学习工程化还有顾虑，BuildAdmin 演示站首页的文案于君共勉：

人们正是受够了茹毛饮血的野蛮生活，才鼓起勇气从天上借来了驱散黑暗时代的火；

而当人们终于学会靠自己的力量点燃柴垛，手握火种的祭祀便悄无声息的退出历史舞台，这对手握火种的人并非是一种遗憾，如果他不主动迈向新时代，他的族群终有一日会被黑暗吞没。

BuildAdmin 依赖流行且稳定的技术栈，带你见未来！