pip install caffe 基本不可行，因pypi上无官方caffe包，仅存2015年上传的空占位项目，不兼容python 3.7+且无法import；真实caffe必须从源码编译c++核心并生成pycaffe，再通过配置pythonpath和ld_library_path启用python接口。
直接说结论：pip install caffe 基本不可行，官方 PyPI 上没有可用的 caffe 包，强行执行只会报错或装上一个空壳/废弃项目。
为什么 pip install caffe 会失败
PyPI 上确实存在一个名为 caffe 的包（pip show caffe 可查），但它不是 BVLC 官方 Caffe，而是 2015 年上传的占位项目，无任何代码、不兼容 Python 3.7+、无法 import。真实 Caffe 从未发布 wheel 到 PyPI，因为其 Python 接口严重依赖编译后的 C++ 库（libcaffe.so / libcaffe.dylib），必须本地构建。
- macOS 下执行
pip install caffe→ 安装空包 →import caffe报ModuleNotFoundError - Linux 下同理，甚至可能因缺失
protobuf或boost_python编译失败而静默退出 - Windows 上 pip 完全不支持，连占位包都可能安装失败
正确安装路径：必须从源码编译 + 手动链接 Python 接口
核心动作不是“pip 安装”，而是：先编译 Caffe 本体，再把 python/ 目录加入 Python 路径。关键步骤如下：
- 确保已安装全部系统依赖：
protobuf-devel、boost-python、hdf5-devel、opencv-devel等（Ubuntu 用apt-get install libprotobuf-dev libboost-python1.71-dev） - 克隆源码：
git clone https://github.com/BVLC/caffe.git（推荐--depth 1加速） - 进入
caffe/目录，复制并修改Makefile.config：取消CPU_ONLY := 1注释（如仅 CPU）、修正PYTHON_INCLUDE和PYTHON_LIB路径（尤其虚拟环境用户，需指向venv/include/python3.xm和venv/lib） - 执行
make all -j$(nproc)→ 成功后生成.build_release/lib/libcaffe.so - 最后一步才是“Python 接口启用”：
make pycaffe→ 会在python/下生成caffe/_caffe.so
常见 import 失败的真正原因和修复点
即使 make pycaffe 成功，import caffe 仍报错，90% 是以下三个问题之一：
-
ImportError: libcaffe.so: cannot open shared object file→ 缺少LD_LIBRARY_PATH：运行前执行export LD_LIBRARY_PATH=$PWD/.build_release/lib:$LD_LIBRARY_PATH -
ModuleNotFoundError: No module named 'caffe'→ Python 找不到python/目录：临时加路径export PYTHONPATH=$PWD/python:$PYTHONPATH，或永久写入~/.bashrc - PyCharm / Jupyter 里 import 失败 → IDE 使用了独立解释器，未继承 shell 的
PYTHONPATH和LD_LIBRARY_PATH；必须在 PyCharm 的 Run Configuration → Environment Variables 里手动补全这两个变量
最易被忽略的是：Caffe 的 Python 接口不是“安装后即用”的包，它本质是本地编译产物的路径绑定。任何脱离 $PWD/python 和 .build_release/lib 的操作，都会让 import 彻底失效——这不是 pip 能解决的问题，也不是重装就能绕过的流程。
