一、 环境安装

本软件推荐使用 Python 3.12 系列 环境。（Ubuntu 24.04.4 LTS 自带 Python 3.12 系列环境，此系统下可直接 跳过 该步骤）

---

1. 下载 Python 3.12

建议从 Python 官方网站下载最新的 3.12 稳定版：

• 官方下载页面: Python 全版本列表
• 推荐下载项: 寻找页面中3.12系列相关的 Windows installer (64-bit)，如 Python 3.12.4 。

---

2. 关键安装步骤

为了确保软件能够被系统识别，请在安装时务必执行以下操作：

2.1 启动安装

1. 运行下载的 .exe 安装程序。
2. 重点（必选）：在安装首界面勾选 "Add Python.exe to PATH"。

   如果不勾选此项，你将无法在终端直接使用 python 命令。

3. 点击 "Install Now" 或根据需要选择自定义安装。

2.2 禁用路径长度限制（可选）

安装结束时，如果界面出现 "Disable path length limit" 选项，建议点击。这可以避免在处理深度学习模型等深层文件路径时出错。

---

3. 环境验证

安装完成后，请打开命令行（CMD 或 PowerShell），输入以下命令检查：

# 验证 Python 版本（只要显示 3.12.x 即可）
python --version

---