Win32/MFC应用UTF-8资源对话框仅显示字符串首字符问题

问题根因 #

当字符集设置为“未设置”（默认使用ANSI/-A系列函数）时，资源编译器对对话框静态文本的处理逻辑存在缺陷：即便添加了#pragma code_page(65001)，若资源文件格式或编译配置不当，UTF-8编码的日文汉字会被错误解析为单字节ANSI字符，多字节编码中的部分字节会被误判为字符串终止符，导致仅显示第一个字符。而字符串表的文本加载逻辑与对话框控件不同，因此能正常解析UTF-8内容。

解决方案 #

• 强制资源文件为UTF-8带BOM格式：用Notepad++打开.rc文件，选择「编码」→「UTF-8（带BOM）」保存。资源编译器对带BOM的UTF-8文件编码识别优先级更高，配合#pragma code_page(65001)可确保正确解析所有多字节文本。
• 设置资源编译的代码页：在Visual Studio中右键资源文件→「属性」→「常规」，将「代码页」设置为65001 (UTF-8)，覆盖系统默认本地代码页，确保资源编译全程用UTF-8解析文本。
• 手动初始化控件文本：若上述配置仍无效，将对话框控件的静态文本迁移到字符串表，在对话框的OnInitDialog函数中调用SetDlgItemTextA从字符串表读取文本并设置到对应控件，完全绕过资源加载时的编码转换问题。
• 确认函数调用版本：确保所有控件文本操作都使用-A系列函数（如SetDlgItemTextA、GetDlgItemTextA），避免因隐式转换调用Unicode版本函数导致编码混乱。

验证步骤 #

1. 单独编译资源文件（右键资源文件选择「编译」）
2. 启动程序，检查对话框静态控件、按钮的日文文本是否完整显示
3. 测试与外部UTF-8系统的交互是否正常

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