【赫兹威客】框架模板-后端命令行部署教程

本教程详细介绍不使用bat脚本，通过命令行手动完成后端部署的完整流程，操作前需确保已完成Python解释器安装（参考基础软件安装中的Python解释器安装步骤）及PyCharm软件安装，且项目已准备就绪。

一、前置条件

• Python 3.12.10（或兼容版本）已安装并配置好环境变量

• PyCharm（推荐社区版2025.1.1.1及以上）已安装

• 后端项目文件已获取并可正常访问

二、详细部署步骤

步骤1：导入项目并打开PyCharm终端

1.将项目拖入到PyCharm软件中。

2. 在PyCharm界面底部找到"Terminal"（终端）选项卡，点击打开，确保终端的工作目录为项目根目录（终端前缀显示项目根目录路径，如"hertz_django >"）。

步骤2：创建并激活虚拟环境

1. 在终端中执行虚拟环境创建命令，用于隔离项目依赖，避免与系统环境冲突：

python -m venv venv

• 命令执行完成后，项目根目录会自动生成名为"venv"的文件夹，该文件夹包含虚拟环境的所有相关文件。

3. 执行虚拟环境激活命令，激活虚拟环境：

venv\Scripts\activate

4. 激活成功后，终端命令行前缀会显示"(venv)"标识，表明当前操作已处于虚拟环境中：

步骤3：获取机器码并完成设备激活

1. 在虚拟环境激活状态下，执行项目中的机器码生成脚本，获取当前设备的唯一机器码，命令如下：

python get_machine_code.py

2. 脚本运行后，会在终端输出设备机器码（如"当前设备机器码：XXX-XXX-XXX"），将该机器码准确提供给相关工作人员，完成设备激活操作。

3. 等待工作人员反馈激活完成后，方可进行后续依赖安装步骤，未激活状态下将无法正常安装项目专属依赖。

步骤4：安装项目依赖包

1. 确认项目根目录中存在"requirements.txt"（公共依赖清单）和"hertz.txt"（Hertz官方依赖清单）两个文件，这两个文件记录了项目运行所需的全部依赖及对应版本。

2. 首先安装公共依赖包，在终端执行以下命令，npm会自动读取"requirements.txt"中的配置并下载安装依赖：

pip install -r requirements.txt

3. 公共依赖安装完成后，安装Hertz官方专属依赖包，执行以下命令，通过指定私有源确保依赖包正常下载：

pip install -r hertz.txt -i https://hertz:hertz@hzpypi.hzsystems.cn/simple/

4. 依赖安装过程中，终端会实时显示安装进度，若出现"Successfully installed XXX"提示，则表明对应依赖安装成功。等待所有依赖包安装完成，期间请保持网络稳定，避免安装中断。

步骤5：启动后端服务

1. 保持虚拟环境激活状态，在项目根目录执行后端服务启动命令，启动后端服务：

python start_server.py

2. 服务启动过程中，终端会输出相关日志信息。若出现以下提示信息，则表明后端服务启动成功：