Windows下用CMake和MinGW编译OSQP-Eigen避坑全记录（附Qt项目配置）
Windows下用CMake和MinGW编译OSQP-Eigen避坑全记录（附Qt项目配置）
当你在Windows平台上使用Qt进行机器人控制或优化算法开发时，OSQP-Eigen库无疑是个强大的工具。但当你满怀期待地打开CMake准备编译时，迎接你的可能是一连串令人崩溃的错误提示。本文将带你完整走一遍这个充满陷阱的旅程，从源码准备到最终Qt项目集成，手把手解决那些官方文档没告诉你的坑。
1. 环境准备与源码获取
在开始之前，确保你的系统已经安装了以下工具：
- MinGW-w64（建议使用8.1.0或更高版本）
- CMake（3.15+）
- Git（用于源码获取）
1.1 依赖库版本匹配
这是第一个大坑——版本兼容性。根据实测，以下组合可以确保顺利编译：
| 库名称 | 推荐版本 | 关键说明 |
|---|---|---|
| Eigen | 3.4.0 | 必须使用源码编译 |
| OSQP | 0.6.3 | 最新版可能与OSQP-Eigen不兼容 |
| OSQP-Eigen | 0.8.1 | 需要手动修改头文件引用方式 |
获取源码时，建议使用以下命令指定版本：
# OSQP (必须指定0.6.3版本) git clone --recursive -b release-0.6.3 https://github.com/oxfordcontrol/osqp.git # OSQP-Eigen git clone https://github.com/robotology/osqp-eigen.git注意：直接下载master分支可能导致版本不匹配，这是后续编译失败的常见原因。
2. Eigen3的安装与配置
虽然Eigen是纯头文件库，但在Windows下的配置也有讲究。
2.1 非标准安装路径问题
如果你没有将Eigen安装在标准路径（如C:\Program Files），CMake很可能找不到它。解决方法是在CMake命令中显式指定路径：
cmake -DEigen3_DIR="D:/Libs/eigen-3.4.0" -G "MinGW Makefiles" ..2.2 FindEigen3.cmake文件缺失
当看到Could NOT find Eigen3 (missing: EIGEN3_INCLUDE_DIR)错误时，需要：
- 从Eigen源码的
cmake/目录复制FindEigen3.cmake - 粘贴到CMake的模块目录，如
C:\Program Files\CMake\share\cmake-3.27\Modules
3. OSQP编译的特殊处理
OSQP的编译过程看似简单，但有几个关键点需要注意。
3.1 安装路径中的括号问题
永远不要使用包含空格或括号的默认安装路径（如Program Files (x86)）。建议在CMake时指定自定义路径：
cmake -G "MinGW Makefiles" -DCMAKE_INSTALL_PREFIX="D:/Libs/osqp-0.6.3" ..3.2 并行编译可能失败
使用-j参数加速编译可能导致奇怪错误。稳妥的做法是：
cmake --build . --target install --config Release4. OSQP-Eigen的编译陷阱
这是问题最多的环节，需要格外小心。
4.1 头文件引用方式修正
编译成功后集成到Qt项目时，你会遇到osqp.h: No such file or directory错误。这是因为OSQP-Eigen的头文件引用方式与Windows下的实际路径不符。需要手动修改以下文件：
osqp-eigen/include/OsqpEigen/Compat.hpp：// 修改前 #include <osqp.h> // 修改后 #include <osqp/osqp.h>osqp-eigen/include/OsqpEigen/Solver.tpp：// 修改前 #include <auxil.h> #include <scaling.h> // 修改后 #include <osqp/auxil.h> #include <osqp/scaling.h>
4.2 MinGW特定编译选项
在Windows下使用MinGW时，需要添加以下CMake选项：
cmake -G "MinGW Makefiles" \ -DCMAKE_SH="CMAKE_SH-NOTFOUND" \ -DCMAKE_BUILD_TYPE=Release \ ..5. Qt项目集成实战
完成库的编译后，如何在Qt项目中正确使用？
5.1 .pro文件配置示例
# 添加包含路径 INCLUDEPATH += "D:/Libs/eigen-3.4.0" INCLUDEPATH += "D:/Libs/osqp-0.6.3/include" INCLUDEPATH += "D:/Libs/osqp-eigen-0.8.1/include" # 添加库路径 LIBS += -L"D:/Libs/osqp-0.6.3/lib" -losqp LIBS += -L"D:/Libs/osqp-eigen-0.8.1/lib" -lOsqpEigen5.2 常见链接错误解决
如果遇到undefined reference错误，检查：
- 库路径是否正确
- 库文件名是否匹配（MinGW生成的库可能带有
.dll.a后缀） - 构建模式是否一致（Debug/Release）
6. 验证安装的测试代码
在Qt项目中创建一个简单的测试用例：
#include <QDebug> #include <OsqpEigen/OsqpEigen.h> void testOsqpEigen() { Eigen::SparseMatrix<double> P(2, 2); Eigen::VectorXd q(2), l(1), u(1); Eigen::SparseMatrix<double> A(1, 2); P.insert(0, 0) = 4; P.insert(0, 1) = 1; P.insert(1, 0) = 1; P.insert(1, 1) = 2; q << 1, 1; A.insert(0, 0) = 1; A.insert(0, 1) = 1; l << 1; u << 1; OsqpEigen::Solver solver; solver.settings()->setVerbosity(false); solver.data()->setNumberOfVariables(2); solver.data()->setNumberOfConstraints(1); solver.data()->setHessianMatrix(P); solver.data()->setGradient(q); solver.data()->setLinearConstraintsMatrix(A); solver.data()->setLowerBound(l); solver.data()->setUpperBound(u); if(!solver.initSolver()){ qDebug() << "初始化失败"; return; } if(!solver.solve()){ qDebug() << "求解失败"; return; } Eigen::VectorXd solution = solver.getSolution(); qDebug() << "解为:" << solution(0) << solution(1); }7. 性能优化建议
在机器人控制等实时应用中，还需要考虑：
热启动：利用上一次的解作为初始猜测
solver.settings()->setWarmStart(true);参数调优：
solver.settings()->setMaxIteration(4000); solver.settings()->setAbsoluteTolerance(1e-6);矩阵预分配：对于固定维度问题，预先分配好稀疏矩阵内存
P.reserve(Eigen::VectorXi::Constant(2, 3));
8. 跨平台兼容性处理
如果你的代码需要在Linux和Windows下运行，可以使用预处理指令处理路径差异：
#ifdef _WIN32 #include <osqp/osqp.h> #else #include <osqp.h> #endif或者在CMake中统一处理：
target_compile_definitions(your_target PRIVATE $<$<PLATFORM_ID:Windows>:OSQP_USE_WINDOWS_PATH_STYLE>)经过这些步骤，你应该能在Windows+Qt+MinGW环境下顺利使用OSQP-Eigen了。记住，每次环境变更（如升级编译器版本）都可能需要重新编译所有依赖库，建议保留好编译成功的库版本备份。