Windows 下 CMake + OpenCV 编译乱码问题的定位与解决(Msbuild 乱码问题)

工程笔记：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. 实施步骤

1. 安装 Ninja：
   winget install Ninja-build.Ninja
2. VS Code 中选择 Kit：Visual Studio 2022 - amd64
3. 设置 CMake generator 为 Ninja
4. Delete Cache and Reconfigure 后重新 Build

6. 结果

• 构建输出全英文、无乱码
• OpenCV(vc16) 正常工作
• Debug / Release 与 MSBuild 行为一致

7. Ninja 简述

• Ninja 是构建执行器（build tool）
• 只负责执行 CMake 生成的构建规则
• 特点：快、安静、可预测
• 不解析 CMakeLists，不管理编译器

8. 工程经验总结

• 不要试图修复 MSBuild 的编码问题
• Ninja + MSVC 是 Windows 上常见且稳定的工程组合
• 本次解决的是工具链噪音，而非业务代码问题