工程笔记：Windows 下 CMake + OpenCV 编译乱码问题的定位与解决
1. 问题背景
-
Windows 11 + VS Code + CMake + OpenCV(vc16) + MSVC
-
使用 Visual Studio generator + MSBuild 时，构建输出出现中文乱码
閫傜敤浜� .NET Framework MSBuild 鐗堟湰 ... -
典型表现：日志可读性极差，但编译本身可能成功
2. 初步尝试（失败方案）
- 强制 UTF-8（/utf-8、VSLANG=1033）
- 结果：MSBuild 输出语言和编码不可控，无法稳定解决
- 尝试切换 g++ / MinGW
- 结果：OpenCV(vc16) 与 MinGW ABI 不兼容，问题升级
3. 关键判断
- 乱码来源不是 CMake，也不是 OpenCV
- 根因是 MSBuild 在 Windows 下的本地化输出 + 编码链路
- 工程上应绕开 MSBuild，而非试图修复其输出
4. 最终解决方案
- 保留 MSVC（兼容官方 OpenCV Windows Pack）
- 使用 Ninja 作为构建执行器
- 构建链路：CMake → Ninja → MSVC(cl.exe)
5. 实施步骤
- 安装 Ninja：
winget install Ninja-build.Ninja - VS Code 中选择 Kit：Visual Studio 2022 - amd64
- 设置 CMake generator 为 Ninja
- Delete Cache and Reconfigure 后重新 Build
6. 结果
- 构建输出全英文、无乱码
- OpenCV(vc16) 正常工作
- Debug / Release 与 MSBuild 行为一致
7. Ninja 简述
- Ninja 是构建执行器（build tool）
- 只负责执行 CMake 生成的构建规则
- 特点：快、安静、可预测
- 不解析 CMakeLists，不管理编译器
8. 工程经验总结
- 不要试图修复 MSBuild 的编码问题
- Ninja + MSVC 是 Windows 上常见且稳定的工程组合
- 本次解决的是工具链噪音，而非业务代码问题