[python模块]python3.13版本编译dlib的whl文件，快速安装dlib库

1. 构建工具和依赖

dlib 是一个 C++ 库，构建过程需要编译，因此需要安装必要的编译工具和依赖库。    

解决办法

• 安装 Visual Studio Build Tools
  • 从 Visual Studio 官网 下载并安装 “Visual Studio Build Tools”。
  • 安装过程中，确保勾选 “C++ 生成工具” 工作负载，同时包含 MSVC 编译器和 Windows SDK。
  • 安装完成后，将相关路径添加到系统的 PATH 环境变量中。常见的 MSVC 编译器路径（以 Visual Studio 2022 为例）可能是 C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\版本号\bin\Hostx64\x64，需要将其添加到 PATH 变量。
• 安装 CMake
• 从 CMake 官网 下载并安装 CMake。安装时选择将其添加到系统环境变量中，这样系统才能找到 CMake 命令。
• 安装Boost
  dlib依赖于Boost库。

2. pip、setuptools 和 build 版本问题

较旧版本的 pip、setuptools 和 build 可能存在兼容性问题，导致构建失败。

解决办法

在命令提示符或 PowerShell 中执行以下命令，更新这些工具到最新版本：

pip install --upgrade pip setuptools build

3. 项目配置文件问题

pyproject.toml 文件可能存在错误或配置不完整，导致构建后端无法正确获取所需依赖。

解决办法

• 检查 pyproject.toml 文件：确保 pyproject.toml 文件中的 [build-system] 部分配置正确。以下是一个示例：

[build-system]
requires = ["setuptools", "wheel"]
build-backend = "setuptools.build_meta"

• 如果没有 pyproject.toml 文件：可以手动创建一个，并添加上述内容。

4. 磁盘空间和权限问题

磁盘空间不足或缺少文件访问权限可能导致构建过程失败。

解决办法

• 检查磁盘空间：确保系统盘（通常是 C 盘）有足够的可用空间，建议至少保留 5GB 以上的可用空间。
• 以管理员身份运行命令行工具：右键点击命令提示符或 PowerShell 图标，选择 “以管理员身份运行”，然后在其中执行构建命令。

5. 执行构建命令

在命令提示符或 PowerShell 中，使用 cd 命令切换到项目根目录，然后执行构建命令：

python -m build --wheel

通过将 pyproject.toml 文件放置在项目根目录下，build 工具就能正确读取配置信息，从而顺利构建 wheel 文件。

• 重新构建：完成清理后，再次尝试执行构建命令：

python -m build --wheel

注：

当出现 error: Cannot update time stamp of directory 'tools/python\dlib.egg-info' 错误时，通常意味着在更新 dlib.egg-info 目录的时间戳时遇到了权限问题或者磁盘问题。以下是详细的分析和解决办法：

1. 权限问题

在 Windows 系统中，如果没有足够的权限来修改文件或目录的时间戳，就会出现此错误。

解决办法

• 以管理员身份运行命令提示符或 PowerShell：
  • 在开始菜单中找到命令提示符或 PowerShell 的图标。
  • 右键点击图标，选择 “以管理员身份运行”。
  • 在新打开的具有管理员权限的窗口中，使用 cd 命令切换到 dlib 项目的根目录，然后再次尝试执行构建命令，例如：

python -m build --wheel

• 检查文件和目录权限：
  • 找到 dlib 项目所在的文件夹，右键点击该文件夹，选择 “属性”。
  • 在弹出的属性窗口中，切换到 “安全” 选项卡。
  • 确保当前用户具有 “完全控制” 权限。如果权限不足，可以点击 “编辑” 按钮，修改权限设置。