Windows下如何解决MinGW编译SFML 64位+C++23运行时DLL入口错误？

环境与操作步骤 #

• 已下载并解压适配GCC 7.3.0 MinGW (SEH) - 64-bit的SFML 2.5.1版本
• 已将SFML的DLL文件复制到存放main.cpp的项目根目录
• 已将SFML的include和lib文件夹复制到项目的src目录下
• 通过Chocolatey安装MinGW-w64（命令：choco install mingw）
• 已将MinGW的bin目录添加到当前用户的环境变量Path中
• 编译命令：

  g++ -std=c++23 -Wall -Wextra -I src/include *.cpp -o wizard.exe -L src/lib -lsfml-graphics -lsfml-window -lsfml-system
  

代码示例 #

#include <SFML/Window.hpp>

int main()
{
    sf::Window window(sf::VideoMode(800, 600), "My window");
    while (window.isOpen())
    {
        sf::Event event;
        while (window.pollEvent(event))
        {
            if (event.type == sf::Event::Closed)
                window.close();
        }
    }
    return 0;
}

问题现象 #

编译过程无报错，但运行wizard.exe时提示找不到DLL中的程序入口点，无法正常启动。尝试通过MSYS2重装MinGW后，编译仍正常，但运行错误依旧。

1. 严格匹配MinGW与SFML的编译版本 #

SFML 2.5.1的该预编译包是用GCC 7.3.0编译的，而Chocolatey默认安装的是较新版本MinGW（如GCC 12+），版本不兼容会导致DLL入口点不匹配：

• 卸载当前MinGW：choco uninstall mingw
• 安装GCC 7.3.0版本、64位、SEH异常模型的MinGW-w64，确保和SFML的编译环境完全一致。

2. 检查DLL文件的正确性 #

• 确认复制到项目根目录的DLL是SFML解压包bin目录下的64位SEH版本，不要混用32位或SJLj异常模型的DLL。
• 核对DLL文件名：确保使用sfml-graphics-2.dll、sfml-window-2.dll、sfml-system-2.dll这类动态库文件，与编译时链接的libsfml-graphics.a等静态导入库对应。

3. 降低C++标准版本 #

SFML 2.5.1发布时C23尚未正式定稿，过高的标准可能引发兼容性问题，建议调整为SFML支持的C17：

g++ -std=c++17 -Wall -Wextra -I src/include *.cpp -o wizard.exe -L src/lib -lsfml-graphics -lsfml-window -lsfml-system

4. 验证运行时依赖 #

• 确保MinGW的核心依赖DLL（如libstdc++-6.dll、libgcc_s_seh-1.dll）能被系统找到，这些文件在MinGW的bin目录下，若Path已配置仍有问题，可将它们复制到项目根目录。
• 重启命令行窗口，确保环境变量修改生效后再重新编译运行。

内容的提问来源于stack exchange，提问作者A. Katzenberger