在 Windows 上使用 Clang 链接 SDL2 时出错“LNK1561：必须定义入口点”

Posted 2023-02-21

【中文标题】在 Windows 上使用 Clang 链接 SDL2 时出错“LNK1561：必须定义入口点”

【英文标题】：Error when Linking SDL2 using Clang on Windows "LNK1561: entry point must be defined"

【发布时间】：2017-02-13 17:54:26

【问题描述】：

我正在尝试在 Windows 上使用 clang 来编译和链接 SDL2 应用程序。

这样做的原因是尝试使我的开发环境与其他使用 OSX 和 XCode（使用 clang 编译）的团队成员保持一致。由于 Visual C++ 编译器比 clang 编译器严格得多，我可能会提交无法在 clang 下编译的更改。

我宁愿不必安装 VS 2015 来使用实验性 LLVM 构建环境：（链接已删除）

我已经在 windows 上安装了 LLVM/clang 工具（不是从源代码构建的，只是从这里下载了二进制文件：（链接已删除））并且可以使用 clang 成功构建和运行“hello world”控制台应用程序。

我想做的是有一个批处理文件，允许我定期构建和链接 clang，以确保我的代码可以安全地提交。

在链接一个简单的单文件 SDL2 应用程序时，我收到以下链接器错误：

LINK : fatal error LNK1561: entry point must be defined
clang++.exe: error: linker command failed with exit code 1561 (use -v to see invocation)

此线程建议设置链接器子系统SDL2: LNK1561: entry point must be defined，尽管我不确定从命令行编译时如何执行此操作。据我了解，未指定时默认应为 CONSOLE 。

我的主要入口点函数的形式是 int main(int argc, char* argv[]) 根据这个线程：Why SDL defines main macro?

这是我正在使用的 bat 文件：

CALL "C:\Program Files (x86)\Microsoft Visual Studio 12.0\VC\bin\vcvars32.bat"
clang++ -std=c++11 main.cpp -I./include/SDL2 -L./lib -lSDL2main -lSDL2

据我所知，包含和库目录是正确的。链接器可以找到库，编译器可以看到包含文件。

为了简单起见，我用来测试编译器/链接器的代码直接来自lazy foo 的介绍教程：http://lazyfoo.net/tutorials/SDL/01_hello_SDL/index2.php

/*This source code copyrighted by Lazy Foo' Productions (2004-2015)
and may not be redistributed without written permission.*/

//Using SDL and standard IO
#include <SDL.h>
#include <stdio.h>

//Screen dimension constants
const int SCREEN_WIDTH = 640;
const int SCREEN_HEIGHT = 480;

int main( int argc, char* args[] )

    //The window we'll be rendering to
    SDL_Window* window = NULL;

    //The surface contained by the window
    SDL_Surface* screenSurface = NULL;

    //Initialize SDL
    if( SDL_Init( SDL_INIT_VIDEO ) < 0 )
    
        printf( "SDL could not initialize! SDL_Error: %s\n", SDL_GetError() );
    
    else
    
        //Create window
        window = SDL_CreateWindow( "SDL Tutorial", SDL_WINDOWPOS_UNDEFINED, SDL_WINDOWPOS_UNDEFINED, SCREEN_WIDTH, SCREEN_HEIGHT, SDL_WINDOW_SHOWN );
        if( window == NULL )
        
            printf( "Window could not be created! SDL_Error: %s\n", SDL_GetError() );
        
        else
        
            //Get window surface
            screenSurface = SDL_GetWindowSurface( window );

            //Fill the surface white
            SDL_FillRect( screenSurface, NULL, SDL_MapRGB( screenSurface->format, 0xFF, 0xFF, 0xFF ) );

            //Update the surface
            SDL_UpdateWindowSurface( window );

            //Wait two seconds
            SDL_Delay( 2000 );
        
    

    //Destroy window
    SDL_DestroyWindow( window );

    //Quit SDL subsystems
    SDL_Quit();

    return 0;

有人知道为什么我在 windows 下使用 clang 链接 SDL 时会收到此链接器错误吗？

【参考方案1】：

MSVC 链接器使用/subsystem:windows 选项设置GUI 模式（并使用WinMain 而不是main），因此您需要传递它：

clang++ -std=c++11 main.cpp -I./include/SDL2 -L./lib -lSDL2main -lSDL2 -Xlinker /subsystem:windows

【讨论】：

请注意-lSDL2main - 在与SDL2 链接之前，必须先与SDL2main 链接。

好吧，它在原始问题中已经处于“正确”的顺序，但无论如何 - 仅使用 GNU 链接器。 MSVC 链接器不关心库顺序。

非常感谢凯尔塔！解决了！谢谢你，Ivan，我对此感到疑惑，所以我从一个旧项目的以前工作的 shell 脚本中提取了这个命令。

使用当前版本，它提供sdl2main.lib(SDL_windows_main.obj) : error LNK2019: unresolved external symbol __imp_CommandLineToArgvW referenced in function main_getcmdline。在他们的论坛上发布了question。

对于这个特定的例子，如果不与-lShell32 链接，我无法让它工作。

【参考方案2】：

LINK：致命错误 LNK1561：必须定义入口点 clang++.exe：错误：链接器命令失败，退出代码为 1561（使用 -v 查看调用）

这通常发生在您没有 main(...) 函数时。

SDL “窃取”了主要功能，因此您的 int main(int, argc[]*) 并不是真正的入口点。

入口点在SDL2main.lib 中定义。您必须告诉 clang 的链接器与它链接。 （注意：必须在SDL2之前链接SDL2main。）

还要注意，无论您在哪里定义 main(...) 函数，都必须 #include "SDL.h"。

【讨论】：

谢谢 Ivan，我以前也遇到过这些问题，但这次不是这样。我未能明确指定链接器要使用的子系统（请参阅上面 keltar 的回答）