Windows下C++工程编译报中文路径错误，根本原因是工具链将UTF-8路径字节误作GBK解码，导致g++找不到文件、CMake检测失败或std::ifstream无法打开；需统一源码编码、命令行传参、API调用三层UTF-8处理，而非仅改单点配置。
Windows下C++工程编译报中文路径错误，基本可以确定是编译器或构建系统在解析路径时把UTF-8字节当GBK解码了——gcc.exe、g++.exe、cl.exe本身不直接崩溃，但调用它们的工具链（如CMake、IDE、Make）在拼接命令行参数时会因编码错乱导致文件找不到、头文件无法打开、临时目录创建失败等现象。
为什么g++命令行里含中文路径就失败
MinGW-w64的gcc.exe和g++.exe本身支持宽字符启动（CreateProcessW），但Dev-C++、CLion、CMake等上层工具在生成命令行字符串时，常把路径作为窄字符串（char*）传入。Windows命令行子系统（cmd.exe或conhost.exe）默认使用OEM代码页（如CP936），而你的源码文件若保存为UTF-8，"./项目/main.cpp"这段字面量在内存中就是UTF-8字节序列，被当作GBK去解释，结果路径变成乱码，g++自然找不到文件。
- 运行
where g++能返回路径 ≠ 路径在编译时能被正确传递 - 即使
g++ -v成功，也不代表它能处理含中文的-I或-o参数 - 错误提示常为：
fatal error: no input files、no such file or directory、invalid argument，但实际文件存在且可手动用资源管理器打开
CMake配置时No CMAKE_C_COMPILER could be found的中文路径陷阱
这个报错表面是找不到编译器，实则常因CMake自身在检测阶段尝试用中文路径写临时测试文件（如CMakeFiles/CMakeTmp/testCCompiler.c）失败所致。CMake 3.20+虽增强Unicode支持，但若其调用的gcc.exe所在路径含中文，或CMakeLists.txt里project()所在目录含中文，仍会触发is not able to compile a simple test program。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 先验证：把整个工程移到纯英文路径（如
C:/dev/myproj），再运行cmake -G "MinGW Makefiles" ..，若成功则锁定是路径问题 - 不要依赖
set(CMAKE_CXX_STANDARD 17)这类语句掩盖路径缺陷——标准版本不影响路径解析 - CMake GUI界面里显示“Compiler is OK”，不代表CLI下
cmake ..也OK，GUI可能绕过某些路径校验逻辑
std::ifstream打开中文路径文件失败，不是编译问题而是运行时API选择错误
很多开发者以为编译通过就万事大吉，结果程序运行时std::ifstream f("数据/配置.json");返回!f.is_open()。这不是bug，是Windows API设计使然：std::ifstream底层调用CreateFileA，强制按当前ANSI代码页（如GBK）解码传入的UTF-8字符串，导致路径无效。
立即学习“C++免费学习笔记（深入）”；
- 别改控制台代码页（
SetConsoleOutputCP(CP_UTF8)），它不影响CreateFileA行为 - 别用
std::filesystem::path("数据/配置.json").c_str()喂给std::ifstream——.c_str()返回的是ANSI编码窄字符串，不是UTF-8 - 正确做法：用
std::wifstream+std::wstring，并确保源文件保存为UTF-8 with BOM，或用MultiByteToWideChar(CP_UTF8, ...)转换 - 超长路径（>260字符）必须加
L"\\?\"前缀，且仅对绝对路径有效；相对路径需先std::filesystem::absolute()
真正棘手的不是“怎么改”，而是“改哪一层”：IDE配置、环境变量、CMake脚本、源码字符串、还是运行时路径构造？多数人卡在只动了其中一层，比如改了Dev-C++的编译器路径却没清空旧工程的.devcpp缓存，或在CLion里重配了Toolchain却忘了删掉cmake-build-debug目录里的中文路径残留。路径问题从来不是单点故障，而是一条从编辑器到Win32 API的编码信任链断裂。
