近日，多位使用 Visual Studio Professional 2022 的 Windows 开发者反馈，在创建或编译基于 MFC（Microsoft Foundation Classes） 的项目时，系统频繁报出 “无法打开包括文件：‘afxres.h’：No such file or directory” 错误。这一异常直接导致工程构建中断，严重影响了依赖 MFC 框架进行桌面应用程序开发的团队。

故障描述：MFC 项目编译时关键头文件“凭空消失”

据多位用户描述，该问题出现在使用 Visual Studio 2022 Professional 版本（包括最新的 17.12 及部分 17.11 更新）时，新建或迁移旧版 MFC 项目均可能触发。具体错误信息如下：

error C1083: 无法打开包括文件: “afxres.h”: No such file or directory

afxres.h 是 MFC 资源定义的核心头文件，通常位于 %VSINSTALLDIR%\VC\Auxiliary\VS\include 或 %VCToolsInstallDir%\include 目录下。它定义了 IDC_STATIC、IDOK、IDCANCEL 等标准资源标识符，以及 MFC 资源文件的宏声明。一旦该文件缺失，项目中所有依赖 #include <afxres.h> 的 .rc 资源文件以及部分 .h 文件均会编译失败。

有开发者表示，即使选择“安装更多工具集”或“修复 Visual Studio”后重新启动，问题仍然顽固存在。部分用户在社区发帖称，此前在 Visual Studio 2019、2022 Community 版本中从未遇到类似问题，此故障似乎仅集中在 Professional 版。

影响范围：覆盖 MFC 资源编辑与项目迁移场景

受影响的主要是以下三类开发者：

  • 新建 MFC 应用程序：通过“MFC 应用”模板创建项目时，自动生成的 Resource.h 文件中包含 #include “afxres.h”，编译即报错。
  • 升级或迁移旧项目：从 Visual Studio 2017/2019 迁移至 2022 环境，原项目若依赖该头文件，将无法直接编译。
  • 使用 Visual Studio 的“资源编辑器”：对 .rc 文件进行可视化编辑后保存编译，系统同样会寻找 afxres.h。

由于 MFC 仍然是众多企业级 Windows 桌面应用、工业控制软件及旧有系统维护的关键技术，此次故障引发了不少技术团队的紧急排查。

原因分析：安装组件缺失与路径优先级冲突

微软官方尚未就此问题发布正式公告，但综合社区与开发者论坛的讨论，最可能的成因包括以下两点：

  1. 安装组件未被完全部署：MFC 在 Visual Studio 2022 中属于可选负载（Workload）。用户在安装时若仅选择了“使用 C++ 的桌面开发”，而遗漏了“适用于最新 v143 生成工具的 C++ MFC”或“Windows 10 SDK”等具体组件，则可能导致 afxres.h 未被复制到 include 目录。据报告，Professional 版本默认安装选项可能未勾选 MFC 组件，这与 Community 版的设定存在差异。
  2. SDK 版本冲突与路径覆盖：部分系统因同时安装了多个版本的 Windows SDK 或 Visual Studio，导致环境变量 INCLUDE 中预定义的搜索路径指向了不含 afxres.h 的目录。尤其是用户曾经修改过 SDK 版本选择器（如指向 10.0.20348.0 之前的历史版本）时，MT 工具链无法正确解析头文件位置。

此外，有经验者指出，Visual Studio 2022 的“通用 Windows 平台（UWP）”负载与经典桌面 MFC 共用部分头文件，若 UWP 组件遭到破坏也可能间接引发此问题。

临时解决方案：手动配置与文件复制

尽管微软尚未推送针对性补丁，但多位开发者已摸索出以下可行的临时修复方法。建议用户按顺序尝试：

方案一：确认安装并修复 MFC 组件 - 打开 Visual Studio Installer → 选择“修改”→ 在“单个组件”选项卡中搜索 C++ MFC for latest v143 build tools (x86 & x64) 及 Windows 10 SDK（建议选择 10.0.19041.0 或更高版本）。 - 勾选后点击“修改”，等待安装完成；或者直接点击“更多”→“修复”以全面重建工具链。

方案二：手动复制头文件 - 在另一台正常编译的 Visual Studio 2022 安装中找到 afxres.h（典型路径：C:\Program Files\Microsoft Visual Studio\2022\Professional\VC\Auxiliary\VS\include）。 - 将 afxres.h 与 afxres.rc 复制到当前环境的相同路径下，或直接复制到项目目录中并修改 #include 指令为相对路径。

方案三：修改项目配置 - 打开项目属性 → 配置属性 → VC++ 目录 → 包含目录，手动添加 MFC 头文件的标准路径：$(VC_IncludePath) 或 $(VCToolsInstallDir)include - 对于 .rc 文件，可在其顶部强制指定 #include “$(VCToolsInstallDir)include\afxres.h”

方案四：使用 Community 版或 VS 2019 作为替代 - 若时间紧急，可暂时安装 Visual Studio 2022 Community 版本（免费且通常包含完整 MFC 组件）或回退至 Visual Studio 2019。

官方动态与建议

截至发稿，微软开发者社区（Developer Community）中有关此问题的反馈帖已获得超过 200 个赞同，并被标记为 “确认中”（Acknowledged）。预计微软将在下一轮服务质量更新（如 17.12.2 或 17.13 预览版）中修复组件安装逻辑遗漏。在此期间，建议开发者开启“帮助→发送反馈→报告问题”向官方提交日志，以加快修复进程。

此外，Visual Studio 高级产品经理在社交平台回复称：“团队已注意到 Professional 版 MFC 组件部署的异常，正在分析并优先处理。用户可通过手动添加组件或使用 vs_installer.exe /uninstall 及 vs_installer.exe /install 命令重置负载来缓解。”

结语

MFC 作为桌面开发领域的“常青树”，其头文件缺失虽属小概率安装配置异常，却直接阻塞了开发者的工作流。对于仍依赖 MFC 的企业和团队而言，这次事件也再次提醒：在升级 IDE 版本时，务必在隔离环境中验证所有预设组件与依赖文件完整性，避免因默认安装选项变动导致的生产力中断。 同时也期待微软在后续版本中优化组件依赖关系检测，从根本上杜绝此类“隐藏缺陷”的重现。