快速开始
请按步骤要求进行操作，不要遗漏，不要跳节，等运行起来确认没问题后，再自由“折腾”（包括且不限于改包名、删改代码等）。到那时候，再出现无法运行之类的问题，这“锅”可就不能甩了。
本篇文档所涉及 IDE 及版本
后端 IDE：IntelliJ IDEA 2025.1.3 (Ultimate Edition)
前端 IDE：WebStorm 2025.1.3
后端
环境说明
以下是本项目后端所需的运行环境，请确保您具备且环境符合要求，以减少因环境差异导致的问题。
| 运行环境 | 演示环境版本 | 最低版本 | 安装教程 |
|---|---|---|---|
| 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 中打开后端项目。
创建数据库
提前创建好项目数据库，例如：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 获取更多解决方案。
项目启动失败，报错：Could not create connection to database server. Attempted reconnect 3 times. Giving up
问题描述： 配置好 MySQL 数据库后，项目启动失败，会在以下日志处卡住一段时间（时长不定）：
com.zaxxer.hikari.HikariDataSource - HikariPool-1 - Starting...最终控制台报错信息包含：
Could not create connection to database server. Attempted reconnect 3 times. Giving up.
...解决方案： 出现此问题通常是数据库连接配置有误，导致应用无法连接到数据库服务。可根据以下具体错误提示排查问题：
若报错信息末尾包含
Access denied for user 'xxx'@'xxx.xxx.xxx.xxx' (using password: YES)，表示数据库用户名或密码配置错误。若报错信息末尾包含
Communications link failure，表示数据库主机地址（host）或端口（port）配置错误，或数据库服务无法访问。若报错信息末尾包含
Unknown database '数据库名称'，表示指定的数据库不存在。
很多人反馈这个问题后，刚开始一直坚持认为自己配置没问题，我们都是让他在别的项目里用这个数据库服务配置运行试试，或者换个其他数据库服务配置试试，没过多久后大多会来一句：“大意了，xxx写错了！”
前端
环境说明
以下是本项目前端所需的运行环境，请确保您具备且环境符合要求，以减少因环境差异导致的问题。
| 运行环境 | 演示环境版本 | 建议版本 | 安装教程 |
|---|---|---|---|
| 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 中打开
在 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 等广告拦截扩展，如有，请调整规则或在当前页面暂时关闭该扩展。