为何字符集设置无效？如何将Qt项目转回Multi-Byte版本？

问题原因 #

• Qt集成后，其配置可能强制注入了UNICODE或_UNICODE宏，这类宏的优先级高于VS项目的Character Set图形界面设置，导致即便改回Multi-Byte，函数依然按Unicode模式解析。
• 项目预处理器定义中可能残留了UNICODE/_UNICODE宏，未随Character Set设置自动清除。
• 项目继承了Qt的属性文件（如.props），其中的配置覆盖了本地的Character Set设置。

解决步骤 #

1. 清理预处理器宏 #

打开项目属性 → 配置属性 → C/C++ → 预处理器 → 预处理器定义：

• 删除所有UNICODE和_UNICODE宏条目
• 确认存在_MBCS宏（Multi-Byte模式下默认会添加，若缺失则手动补充）

2. 检查Qt配置文件 #

如果项目引入了Qt相关的.props或.pri配置文件，打开文件查找是否有类似DEFINES += UNICODE的代码，找到后直接注释或删除该行。

3. 清除编译缓存并重新生成 #

旧缓存可能导致设置不生效，按以下操作执行：

• 点击VS菜单栏「生成」→「清理解决方案」
• 删除项目目录下的Debug、Release文件夹及.vcxproj.user文件
• 重启VS并重新打开项目，选择对应配置后重新生成

4. 调整头文件包含顺序 #

确保系统头文件（如windows.h）在Qt头文件之前包含，避免Qt头文件提前触发Unicode模式的函数定义。

5. 验证宏定义正确性 #

在任意源码文件开头添加以下代码，编译时验证宏状态：

#ifdef _UNICODE
#error "Unicode宏仍被定义，请检查配置"
#endif
#ifdef UNICODE
#error "Unicode宏仍被定义，请检查配置"
#endif
#ifndef _MBCS
#error "Multi-Byte宏未定义，请检查配置"
#endif

若编译报错，根据错误提示继续排查宏定义的来源即可。

内容的提问来源于stack exchange，提问作者Darros99