本地环境要求

安装前先检查什么？

后端要求 Java 21 与 Maven 3.9.16 至 4 之前的版本；当前配置为 Spring Boot 4.0.8、MyBatis-Plus 3.5.17。

Admin 使用 Vue 3.5.43、Element Plus 2.14.6、Vite 8.3.1；PC 使用 Nuxt 4.5.2；两端锁定 pnpm 10.18.2 和 Node 24。

本地安装说明要求 Python 至少3.9、Docker Desktop 与 Compose v2；初始工具和数据环境通过项目安装入口核对。

工具应从各自正式发行渠道安装，已有版本匹配时直接复用。依赖下载需要可访问 Maven、npm、Docker 镜像和移动工具来源；这些条件不代表生产服务器配置。

怎样查看启动入口参数？

复制python3 deploy/macos.py --help

帮助命令只展示当前脚本参数。随后在自己的开发副本运行 doctor；它检查工具链与 Docker 状态。不要在参考副本或已有业务环境直接运行首次安装。

要准备哪些本地资源？

1. 为数据库、对象存储和三端构建留出独立磁盘空间。
2. 检查本地端口占用，现有进程不要直接结束；按脚本支持参数选择端口。
3. 使用忽略的私有配置目录保存生成的秘密，不放入 Git、普通日志或截图。
4. 移动端 使用工具锁对应插件，未准备好时只记录后端、Admin、PC状态。

移动端采用 uni-app x，支持微信小程序、App 与移动端网页。

如何判定可以开始安装？

工具输出匹配、Docker可用、独立工作目录与数据卷范围已确认，再进入本地启动文档。遇到凭据和正式账号要求按正常授权流程处理，不绕过工具登录。