Windows 下 Caffe 离线安装全攻略：从零到一，手把手搞定

想在 Windows 系统上离线安装 Caffe 进行深度学习研究或开发？这确实是个技术活，尤其在没有网络的环境下，依赖包和配置问题常常让人头疼。别担心，跟着我这套详细流程走，即使是电脑新手，也能一步步成功搭建起 Caffe 环境。

一、安装前准备：兵马未动，粮草先行

在开始安装之前，充分的准备工作能避免你走很多弯路。

1. 系统与环境检查 首先，确认你的 Windows 系统是 64 位版本，建议使用 Windows 10 或 Windows 11。Caffe 对 32 位系统支持不佳，容易出问题。同时，确保你的电脑有至少 20 GB 的可用磁盘空间，因为后续的依赖包和编译文件会占用不少空间。

2. 核心依赖包离线下载 这是离线安装最关键的一步。你需要提前在另一台有网络的电脑上，下载好所有必需的安装包。主要分为以下几类：

Python：到 Python 官网下载 Windows 版本的安装包。建议选择 Python 3.6 或 3.7 版本，与 Caffe 的兼容性更稳定。记得下载 Windows x86-64 executable installer。
Visual Studio：Caffe 在 Windows 下编译需要 VS。推荐下载 Visual Studio 2019 Community 版本，这是免费的。在官网下载离线安装包（ISO文件），大小约20-30GB。
CMake：用于生成编译脚本。下载 Windows win64-x64 版本的 .msi 安装程序。
Git：用于获取 Caffe 源代码。下载 Windows 版本的安装程序。
第三方库：这是最繁琐的部分。你需要下载：
- Boost：下载预编译的 .msi 或 .exe 安装程序。
- OpenCV：下载 Windows 版本的预编译包，例如 opencv-3.4.x-vc14_vc15.exe。
- Protobuf、GLog、GFlags、LMDB、LevelDB、HDF5：这些库通常没有现成的 Windows 二进制包。最稳妥的方法是，在一台有网的电脑上，按照在线教程用 vcpkg（一个C++库管理工具）安装一遍，然后将其整个 vcpkg 的 installed 目录（里面包含了所有编译好的库文件）打包带走。这是离线安装的“捷径”。

3. 获取 Caffe 源代码 同样，在有网络的电脑上，访问 Caffe 在 GitHub 的官方页面，下载整个项目源代码的 ZIP 压缩包。推荐选择一些维护较好的 Windows 分支，例如 https://github.com/BVLC/caffe/tree/windows，下载其 ZIP 文件。

将上述所有下载好的安装包、源代码压缩包、以及打包好的第三方库目录，统一拷贝到一个文件夹内（例如 D:\Caffe_Offline_Packages），然后通过U盘或移动硬盘转移到你的离线工作电脑上。

二、详细安装步骤：步步为营，稳扎稳打

现在，我们开始在离线电脑上正式安装。请严格按照顺序操作。

步骤1：安装 Visual Studio 2019 运行下载好的 VS2019 ISO 文件或安装程序。在安装工作负载选择界面，必须勾选“使用 C++ 的桌面开发”。右侧的安装详细信息中，确保“Windows 10 SDK”或“Windows 11 SDK”被选中。然后进行安装，这个过程可能需要半小时到一小时。

步骤2：安装 Python 和 Git

运行 Python 安装程序。务必勾选 “Add Python 3.x to PATH”，这样系统才能识别 Python 命令。建议安装路径不要有中文和空格，例如 C:\Python36。
运行 Git 安装程序，全部使用默认选项即可。

步骤3：安装 CMake 和基础依赖

安装 CMake，同样建议使用默认路径。
安装 Boost 和 OpenCV 的预编译包。记住它们的安装路径，稍后配置需要用到。

步骤4：部署第三方库 将之前打包好的 vcpkg\installed\x64-windows 目录（里面包含 include, lib, bin 等子文件夹），整体复制到离线电脑的某个路径下，例如 D:\Libs\x64-windows。这个目录现在就是你的“离线库仓库”。

步骤5：准备 Caffe 源代码 将 caffe-windows.zip 解压到一个合适的目录，例如 D:\Projects\caffe。这就是你的工作目录。

步骤6：配置与生成项目（核心环节） 这是最关键的一步，我们将使用 CMake GUI 工具来配置。

打开开始菜单，找到 CMake (cmake-gui) 并运行。
在 “Where is the source code:” 栏，点击 Browse Source...，选择你解压的 Caffe 目录（D:\Projects\caffe）。
在 “Where to build the binaries:” 栏，点击 Browse Build...，在 Caffe 目录下新建一个 build 文件夹并选中它（D:\Projects\caffe\build）。
点击 Configure 按钮。在弹出的对话框中，选择 Visual Studio 16 2019 作为生成器，并选择 x64 平台，点击 Finish。
CMake 开始运行后，会报出一大片红色错误，这是因为找不到各种依赖库。别慌，我们现在手动指定。
在 CMake 的变量列表中找到以下关键变量，点击 Value 栏进行修改。请根据你实际的文件路径进行对应修改：
- BLAS: 选择 open (使用 OpenBLAS) 或保持默认。
- Boost_INCLUDE_DIR: 设置为你的 Boost 安装路径下的 include 文件夹，如 C:\local\boost_1_68_0。
- Boost_LIBRARY_DIR: 设置为 Boost 的 lib 文件夹，如 C:\local\boost_1_68_0\lib64-msvc-14.2。
- OpenCV_DIR: 设置为 OpenCV 的构建配置路径，如 C:\opencv\build\x64\vc15\lib。
- PROTOBUF_INCLUDE_DIR: 设置为你的离线库中 protobuf 的 include 路径，如 D:\Libs\x64-windows\include。
- PROTOBUF_LIBRARY: 设置为 protobuf 的库文件路径，如 D:\Libs\x64-windows\lib\libprotobuf.lib。
- GLOG_INCLUDE_DIR, GLOG_LIBRARY, GFLAGS_INCLUDE_DIR, LMDB_INCLUDE_DIR, LEVELDB_INCLUDE_DIR, HDF5_hdf5_LIBRARY 等：全部按照此模式，指向你 D:\Libs\x64-windows 目录下对应的 include 和 lib 文件。
- 找到 PYTHON_EXECUTABLE：将其设置为你的 Python.exe 路径，如 C:\Python36\python.exe。设置此项后，很多 Python 相关的路径（如 PYTHON_INCLUDE_DIR, PYTHON_LIBRARY）会自动填充，检查一下是否正确。
反复点击 Configure 按钮，直到红色错误区域全部消失，且不再有新的红色条目出现。
点击 Generate 按钮。成功后，点击 Open Project，会自动在 Visual Studio 2019 中打开生成的解决方案。

步骤7：编译 Caffe 在 Visual Studio 中：

将顶部的解决方案配置从 Debug 改为 Release，平台选择 x64。
在右侧的解决方案资源管理器中，找到 caffe 项目，右键点击，选择 “生成”。
编译过程会持续一段时间（10-30分钟），请耐心等待。如果编译成功，你会在输出窗口看到“全部重新生成: 成功 1 个...”的提示。

步骤8：环境变量配置 为了让系统能找到 Caffe，需要添加环境变量：

右键点击“此电脑”->“属性”->“高级系统设置”->“环境变量”。
在“系统变量”或“用户变量”中，找到并编辑 Path 变量。
添加以下两条路径（请替换为你的实际路径）：
- D:\Projects\caffe\build\lib\Release （Caffe 编译生成的库文件路径）
- D:\Projects\caffe\build\tools\Release （Caffe 工具路径，如 caffe.exe）
点击确定保存。

三、验证安装与常见问题排雷

验证是否安装成功：

打开一个新的命令提示符（CMD）或 PowerShell。
输入 python 进入 Python 交互环境。
尝试导入 Caffe：输入 import caffe。
如果没有报错，恭喜你，Caffe 已经成功安装并可以调用了！

你可能遇到的坑及解决办法：

编译时提示“找不到 .dll 文件”：这通常是因为运行时库缺失。将你 D:\Libs\x64-windows\bin 目录下的所有 .dll 文件，复制到 C:\Windows\System32 目录下（不推荐长期这样做），或者更规范地，将 D:\Libs\x64-windows\bin 也添加到系统的 Path 环境变量中。
Python 导入 caffe 报错，提示 DLL 加载失败：同上，确保所有依赖的 DLL 文件（特别是 .pyd 文件所在的目录）都能被系统找到。将 D:\Projects\caffe\build\python\caffe 目录也加入 Path 试试。
CMake 始终找不到某个库：检查路径是否正确，特别注意路径中不要有中文或特殊字符。库的路径应指向包含 .lib 文件的文件夹，而不是 .lib 文件本身（*_LIBRARY 变量除外，它指向具体文件）。
编译过程中大量语法错误：这很可能是 Visual Studio 版本、Windows SDK 版本或第三方库版本不匹配造成的。确保你使用的所有第三方库（尤其是 Boost）都是用相同版本的 Visual Studio（如 MSVC 14.2 for VS2019）编译的。这也是为什么推荐直接打包 vcpkg 已编译目录的原因，它能保证版本一致性。

四、进阶优化与建议

使用 Anaconda 管理 Python 环境（离线）：你可以提前下载 Anaconda 的离线安装包，安装后创建一个独立的 Python 环境来管理 Caffe 的 Python 依赖（如 numpy, scipy, protobuf 的 Python 包等），这样更干净，不影响系统其他 Python 项目。
备份编译环境：一旦编译成功，强烈建议你将整个 Caffe_Offline_Packages 文件夹、D:\Libs 文件夹以及 D:\Projects\caffe 文件夹完整备份。下次在新机器上部署时，可以节省大量时间。
考虑 Docker（高级）：如果条件允许，可以在有网环境下，基于 Windows 的 Docker 制作一个包含完整 Caffe 环境的镜像，然后将镜像导出为文件。在离线环境下导入该镜像即可使用，这是最彻底的解决方案，能完美解决环境依赖问题。