快速开始
前言
请按步骤要求进行操作，不要遗漏，不要跳节，等运行起来确认没问题后，再自由“折腾”（包括且不限于改包名、删改代码等）。到那时候，再出现无法运行之类的问题，这“锅”可就不要甩了。
后端
环境说明
README
以下是本项目后端所需的运行环境，请确保您具备且环境符合要求，以减少因环境差异导致的问题。
| 运行环境 | 演示环境版本 | 最低版本 | 安装教程 |
|---|---|---|---|
| JDK | OpenJDK 17.0.2 | 17 | 《Java 开发环境搭建》 |
| Maven | 3.6.3 | 3.6.3 | - |
| MySQL | 8.0.33 | 5.7.x+ | 《Docker 安装 MySQL》 |
| Redis | 7.2.3 | - |
克隆项目
使用下方 git 命令，将项目克隆到本地开发机器。你也可以选择先在开源平台上将项目 fork 到自己的仓库，然后再将 fork 的项目克隆到本地。正式开发时，请下载最新稳定版，详情见《项目开发》篇。
git clone https://gitcode.com/continew/continew-admin.gitgit clone https://gitee.com/continew/continew-admin.gitgit clone https://github.com/continew-org/continew-admin.git在 IDE 中打开
在 IDE 中打开项目，本指南均以 IntelliJ IDEA 为例，其他 IDE 可根据需要自行查找类似使用方式。
创建数据库
提前创建好项目数据库，例如：continew_admin。
注意
必须是一个空的数据库！不要有任何表！本项目集成了 Liquibase 组件，在项目启动时会自动在数据库中初始化数据表和数据，不需要人工去执行 SQL 脚本。
修改配置
打开 continew-server 模块中的 application-dev.yml 配置文件，将其中的数据源配置、Redis 配置修改为自己实际的环境信息。
启动程序
配置修改完毕后，运行 continew-server 模块中的 ContiNewAdminApplication （Spring Boot 启动类）来启动程序即可。项目启动后，Liquibase 组件会自动执行 continew-server/src/main/resources/db/changelog 目录下的初始化 SQL 脚本。
注意： 是 ContiNewAdminApplication，别启动错了。
等到控制台输出 ContiNew Admin server started successfully.，🎉恭喜你，后端服务启动成功！此时你也可以打开数据库，看看已经初始化好的数据库表及初始数据。
友情提示
后端服务成功启动！你果然很棒！如果这个过程中遇到了未知错误，你也确认自己操作无误的话，可以在常见问题中先找找看。
项目每增长一颗 star，可以给维护者们注入莫大的激情，诚恳的希望您能动动发财的小手，为 ContiNew Admin 点亮一颗小星星。
常见问题
项目依赖下载失败，例如：continew-starter-xxx
请检查以下两点后重新尝试同步依赖：
- 检查 IDEA 的 Maven 配置是否默认使用
已捆绑(Maven 3)，如果是建议更换为本地 Maven 环境 - 检查全局 Maven 配置中是否配有阿里云 Mirror，如果有，请移除或暂时注释该配置（阿里云 Mirror 存在中央仓库依赖同步不及时的问题）
项目无法运行，IntelliJ IDEA 报错 Command line is too long
问题描述： 运行项目时，IntelliJ IDEA 加载完成后未启动程序，而是弹出错误提示：
Error running ContiNewAdminApplication. Command line is too long.解决方案： 在错误提示下方会有 Shorten the command line and rerun. 快捷操作链接，点击即可自动解决并启动项目。如仍未解决，可搜索 Command line is too long 获取更多解决方案。
前端
环境说明
README
以下是本项目前端所需的运行环境，请确保您具备且环境符合要求，以减少因环境差异导致的问题。
| 运行环境 | 演示环境版本 | 建议版本 | 安装教程 |
|---|---|---|---|
| Node | 22.14.0 | >= 20.x | - |
| NPM | 10.9.2 | - | |
| PNPM | 9.12.0 | >= 9.x | - |
本项目前端使用 PNPM（Performant NPM）作为包管理工具。
# 安装 pnpm
npm install -g pnpm
# 查看版本
pnpm -v克隆项目
使用下方 git 命令，将项目克隆到本地开发机器。你也可以选择先在开源平台上将项目 fork 到自己的仓库，然后再将 fork 的项目克隆到本地。正式开发时，请下载最新稳定版，详情见《项目开发》篇。
git clone https://gitcode.com/continew/continew-admin-ui.gitgit clone https://gitee.com/continew/continew-admin-ui.gitgit clone https://github.com/continew-org/continew-admin-ui.git在 IDE 中打开
在 Visual Studio Code 或 WebStorm 等 IDE 中打开项目，本指南均以 WebStorm 为例，其他 IDE 可根据需要自行查找类似使用方式。
安装依赖
打开终端，输入如下命令，安装依赖。
pnpm install
启动程序
依赖安装完成后，打开 package.json 执行 dev 脚本启动。
等到控制台输出如下内容，🎉恭喜你，前端服务启动成功！
前端项目启动成功后，默认浏览器会自动打开登录页面，如果后端项目也已经正常启动，登录页面会出现图形验证码。输入账密及验证码，点击登录，即可开始体验。
| 角色 | 用户名 | 密码 |
|---|---|---|
| 超级管理员 | admin | admin123 |
| 测试员 | test | test123 |
友情提示
🎉 再次恭喜你！ContiNew Admin 已完整启动成功！你真的很优秀！如果这个过程中遇到了未知错误，你也确认自己操作无误的话，可以在常见问题中先找找看。
项目每增长一颗 star，可以给维护者们注入莫大的激情，诚恳的希望您能动动发财的小手，为 ContiNew Admin 点亮一颗小星星。
常见问题
项目安装依赖提示证书过期
问题描述： 使用 pnpm install 安装依赖时，出现类似以下错误：
npm ERR! request to registry.npm.taobao.org failed, reason: certificate has expired解决方案： 淘宝 npm 镜像已于 2021 年从 registry.npm.taobao.org 切换至 registry.npmmirror.com，旧域名已在 2022 年 5 月 31 日停止服务。执行以下命令解决：
# 清空缓存
npm cache clean --force
# 切换至新镜像源
npm config set registry https://registry.npmmirror.com项目启动后，页面空白
问题描述： 前后端项目均启动成功，但访问页面时显示空白，浏览器控制台无报错信息。
解决方案： 据用户反馈，此问题通常与浏览器扩展组件有关。请检查是否启用了 uBlock Origin 等广告拦截扩展，如有，请调整规则或在当前页面暂时关闭该扩展。