本地部署流程文档

带*的步骤为非必须操作

如果需要进行于服务器上的同步开发，则需要进行带*的步骤

完整部署录屏于B站：Django-vue3-admin 本地部署

项目克隆※

1. 打开Pycharm，选择“从VCS开始项目”。
2. 在URL输入框中粘贴Django-vue3-admin的Git地址。
3. 选择本地存储目录，点击“克隆”按钮。
4. 克隆完成后，勾选“信任此项目目录”，并点击确定。

切换分支※

1. 进入项目后，切换到 develop 分支，并拉取分支更新本地项目。

服务器文件同步配置*※

1. 在Pycharm的工具栏中，找到 Tools 并选择 Deployment，点击 Configuration。
2. 在新窗口中，点击左上角加号，选择 SFTP 协议，命名链接并配置SSH连接。
3. 在服务器中创建项目文件夹，设置Root path为该文件夹。
4. 在Mappings选项卡中，设置 Deployment path 为该根路径。
5. 确定后，回到 Deployment 选中 Automatic Upload。

同步项目文件到服务器*※

1. 右键点击项目根目录，选择 Deployment，选择 Upload to my_server。

配置Python解释器※

1. 选中Pycharm右下角的Python版本号，选择添加新的解释器。
2. 在弹出窗口中选择新建虚拟环境，建议在项目根目录外创建虚拟环境文件夹。
3. 选择Python 3.12作为基础解释器，点击“创建”。

安装依赖※

1. 打开终端，进入 backend 代码目录。
2. 更新pip到最新版本，并将pip源更换为清华大学的镜像源。
3. 打开 requirements.txt 文件，删除 mysqlclient 版本限制。
4. 重新运行安装命令，安装依赖包。

数据库配置※

1. 在服务器上使用宝塔面板创建MySQL数据库。
2. 进入 backend/conf 目录，复制配置示例文件，去掉示例名称。
3. 将数据库名称、账号和密码填写到配置文件中。

运行项目和数据库迁移※

1. 试运行项目，确保没有依赖包缺失。
2. 运行数据库迁移命令，去掉命令中的3。
3. 如出现数据库连接失败问题，检查服务器IP地址和数据库配置。
4. 执行初始化命令，同样去掉命令中的3。
5. 点击右上角的“运行”按钮，确保后端成功启动。

前端本地部署※

1. 打开WebStorm，选择“打开文件”，选中项目根目录并打开。
2. 在终端中，进入 web 前端代码目录。
3. 进行npm换源设置，安装yarn。
4. 执行 yarn 命令安装依赖包。

配置和运行前端※

1. 检查Node.js版本，确保大于16.20.1。
2. 创建启动文件，选择 run + dev 命令。
3. 点击右上角的“运行”按钮，启动项目。
4. 在日志中找到前端地址并访问，验证前端页面运行正常。