Hertz System 文档

Appearance

venv 初始化后端参考 ​

本页提供一种基于 Python 自带 venv 管理后端 Python 环境的参考流程，对应的是 Windows 下的标准开发环境搭建方式。整体步骤与《后端项目部署及运行》保持一致，只是单独拎出“虚拟环境 + 依赖安装”部分，方便快速查阅。

一、准备工作 ​

  • 操作系统：Windows 10 / 11（64 位）
  • Python：3.10 及以上（推荐 3.12.3）
  • 已安装 Git，用于拉取代码。

在命令行中确认 Python 可用：

bash
python --version

二、获取后端项目代码 ​

以 HzGit 上的 hertz_django 仓库为例：

bash
git clone <HzGit 仓库地址，例如 http://hzgit.hzsystems.cn/hertz_django_studio/hertz_django>
cd hertz_django

仓库地址以实际项目为准，上面仅为示例。

三、创建并激活 venv 虚拟环境（Windows） ​

在项目根目录下执行：

bash
# 创建虚拟环境
python -m venv venv

# 激活虚拟环境（Windows）
venv\Scripts\activate

激活成功后，命令行前面通常会出现 (venv) 前缀。

四、使用公司私有 PyPI 源安装依赖 ​

在虚拟环境已激活的前提下，执行：

bash
# 升级 pip
python -m pip install --upgrade pip

# 从公司私有 PyPI 源安装依赖
pip install -r requirements.txt -i https://<username>:<password>@hzpypi.hzsystems.cn/simple/

<username> / <password> 由内部运维或技术支持提供，与《后端项目部署及运行》中的说明一致。

五、后续步骤（回到“项目部署及运行”） ​

完成本页步骤后，你已经在本机准备好后端运行所需的 Python 环境。接下来可以回到《后端项目部署及运行》继续执行：

  1. 获取机器码并在激活系统登记。
  2. （可选）按需安装功能插件库（如 YOLO / AI / Wiki）。
  3. 在 settings.py / urls.py 中配置插件。
  4. 运行 python start_server.py --port 8000 启动后端。