dlib

环境要求

• CMake 构建工具（用于配置和编译）
• 支持 C++ 的编译器（如 GCC、Clang 或 Visual Studio）
• Git（用于获取仓库源码）
• Windows 用户建议使用 Visual Studio 并在 64 位模式下编译

安装与启动步骤

1. 1克隆 dlib 仓库

   从 GitHub 拉取源码，README 未给出安装包，统一通过源码编译。网络慢时可先配置代理。

   git clone https://github.com/davisking/dlib.git

   复制

2. 2配置示例工程

   进入 examples 目录，新建 build 子目录并执行 cmake .. 生成构建文件。构建文件必须生成在 build 目录内。

   cd dlib/examples
   mkdir build
   cd build
   cmake ..

   复制

3. 3编译全部示例

   在 build 目录中执行 cmake --build .，会把 examples 下的所有示例程序编译成可执行文件。

   cmake --build .

   复制

4. 4开启 AVX 加速

   若 CPU 支持 AVX 指令，重新配置并编译可让部分功能跑得更快。需在 build 目录内重新执行一次 cmake。

   cmake .. -DUSE_AVX_INSTRUCTIONS=1
   cmake --build .

   复制

5. 5Windows 64 位配置

   Visual Studio 默认 32 位，需显式指定 Win64 生成器与 host=x64，否则可能出现链接或性能问题。

   cmake .. -G "Visual Studio 14 2015 Win64" -T host=x64

   复制

6. 6运行单元测试

   进入 dlib/test 目录编译测试套件并执行 --runall 跑全部测试。Windows 下测试程序可能在 Release 子目录。

   cd dlib/test
   mkdir build
   cd build
   cmake ..
   cmake --build . --config Release
   ./dtest --runall

   复制

关键配置

如何确认成功

示例目录 build 下生成可执行文件即编译成功；运行 dtest --runall 全部用例通过则单元测试成功。

常见问题

注意事项

• README 节选只包含 C++ 编译说明，未给出 Python 绑定的安装命令，需要 Python 接口请查阅官网 dlib.net。
• 示例编译耗时较长，建议在 build 子目录内构建，避免污染源码目录。
• 运行单元测试前必须按 README 步骤先用 --config Release 完成编译。
• 许可证为 Boost Software License，允许闭源商用，保留许可证文件即可。