mfc未安装导致afxwin.h报错，需在vs installer中勾选“mfc和atl支持”；入口为cwinapp派生类的initinstance()；控件变量须在dodataexchange()中用ddx_control绑定id，否则getsafehwnd()断言失败。
VS 安装时没勾选 MFC 组件，afxwin.h 直接报错找不到
不是代码写错了，是开发环境根本没装上 MFC。Visual Studio 默认不安装 MFC，哪怕你选了“桌面开发 with C++”，也得手动勾选子项。
打开 VS Installer → 修改已安装的 VS → 在“工作负载”页确认勾选了“使用 C++ 的桌面开发” → 展开右侧“安装详细信息” → 找到并勾选：MFC 和 ATL 支持（注意有 x86/x64/ARM64 多个版本，按需选，一般先勾 x86 和 x64）。
常见错误现象：fatal error C1083: Cannot open include file: 'afxwin.h': No such file or directory，或者新建项目时根本看不到“MFC 应用程序”模板。
- 重装 VS 或修改安装后，必须重启 VS，否则新建项目里还是不显示 MFC 模板
- 如果用的是 VS Code + vcpkg，
vcpkg install mfcd不能替代原生 MFC，MFC 是 Windows SDK 的一部分，vcpkg 不提供 - 社区版 VS 同样支持 MFC，但企业版/专业版文档更全；社区版安装路径里若出现空格（如
C:\Program Files\...），可能触发某些老项目配置失败
新建项目选“MFC 应用程序”，但生成的代码一堆 AfxMessageBox 和 OnInitDialog，完全看不懂入口在哪
MFC 没有传统 main() 或 wWinMain() 入口可见代码——它被封装在静态库的 DllMain 或隐式链接的启动代码里。你看到的 CMyApp::InitInstance() 才是逻辑起点。
典型结构：全局 CMyApp theApp; 实例触发框架初始化 → 调用 theApp.InitInstance() → 创建主窗口（m_pMainWnd->ShowWindow()）→ 进入消息循环。
-
CWinApp派生类（如CMyApp）的InitInstance()必须返回非零值，否则程序立即退出，且不会报错 - 对话框程序默认把主窗口设为模态对话框，
DoModal()返回后整个程序就结束；想改成非模态或带菜单的 SDI/MDI，新建时就得选对“应用程序类型” - 资源视图里的
IDR_MAINFRAME不只是图标/菜单，它还绑定工具栏、状态栏、加速键，删了其中一项可能导致Create()失败但不提示具体原因
响应按钮点击事件，ClassWizard 已消失，现在怎么加 ON_BN_CLICKED 消息映射
VS 2015 之后 ClassWizard 彻底移除，但消息映射仍靠手写三件套：声明函数、添加宏、实现函数。IDE 可以辅助，但不能全自动。
右键按钮控件 → “添加事件处理程序” → 选择消息类型（如 BN_CLICKED）→ 确认类名 → 勾选“编辑代码” → VS 自动在头文件加 afx_msg void OnBnClickedOk();，在 .cpp 文件加 ON_BN_CLICKED(IDOK, &CMyDlg::OnBnClickedOk) 和空函数体。
- 必须确保函数声明前有
afx_msg，否则编译器不识别为消息处理函数，运行时点击无反应 - 消息映射宏
ON_BN_CLICKED必须放在BEGIN_MESSAGE_MAP / END_MESSAGE_MAP之间，且顺序无关，但位置错乱（比如写在END_MESSAGE_MAP外面）会导致 LNK2001 - 如果按钮 ID 是自定义的（如
IDC_MYBUTTON），要确认资源编辑器里该控件的 ID 真的匹配，ID 写错或拼错（如IDC_MY_BUTTOM）会导致映射失效，点击静默
程序能编译，但一运行就弹 Debug Assertion Failed!，堆栈停在 GetSafeHwnd()
这是 MFC 最典型的“对象未创建就调用”错误，90% 出现在控件变量（CEdit m_edit、CButton m_btn）没关联资源 ID 就直接调用成员函数。
例如：m_edit.SetWindowText(_T("hello")); 在 OnInitDialog() 之前执行，或控件变量声明了但没用 DDX_Control 关联，m_edit.m_hWnd 就是 NULL，GetSafeHwnd() 断言失败。
- 所有控件变量必须在
DoDataExchange()里用DDX_Control(pDX, IDC_MYEDIT, m_edit)显式绑定，缺一不可 - 在
OnInitDialog()里调用控件方法是安全的，但不能早于它（比如构造函数里不行）；也不能晚于CDialog::OnInitDialog()的调用（即必须在return TRUE;之前） - 如果用了
UpdateData(FALSE)，它会触发 DDX，但只更新数据，不建立 HWND 关联——关联只发生在第一次DoDataExchange()被调用时（即OnInitDialog()内部）
复杂点在于：MFC 把资源 ID、C++ 对象、Windows HWND 三者绑死，断掉任意一环都会在运行时崩，而且错误提示和实际位置往往隔了好几层。别信“看起来没问题”，检查 DoDataExchange 和资源 ID 是否完全一致，比调逻辑更快定位问题。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
