VS Code配置MSVC链接器开发Win32桌面应用的问题

问题概述 #

Win32桌面编程新手，在VS Code使用MSVC工具链编译基础空白窗口程序时，编译阶段正常，但链接阶段出现CreateWindowExW、DispatchMessage等Win32 API函数的未解析外部符号错误。该程序在Visual Studio 2022中设置链接器子系统为/SUBSYSTEM:WINDOWS后可正常运行，但无法在VS Code的命令行构建中完成相同配置。

错误信息 #

Executing task: Build with Microsoft (R) MSVC C/C++ Version 19.35.32217.1 for x86 

Starting build...
cl.exe /Zi /MT /MTd /O2 /EHsc /nologo /std:c++20 /FeC:\source\StarTrekArmada\src/Output/NewArmada.exe C:\source\StarTrekArmada/src/*.cpp
cl : Command line warning D9025 : overriding '/MT' with '/MTd'
WinMain.cpp
WinMain.obj : error LNK2019: unresolved external symbol __imp__TranslateMessage@4 referenced in function _WinMain@16
WinMain.obj : error LNK2019: unresolved external symbol __imp__DispatchMessageW@4 referenced in function _WinMain@16
WinMain.obj : error LNK2019: unresolved external symbol __imp__PeekMessageW@20 referenced in function _WinMain@16
WinMain.obj : error LNK2019: unresolved external symbol __imp__DefWindowProcA@16 referenced in function "long __stdcall MainWndProc(struct HWND__ *,unsigned int,unsigned int,long)" (?MainWndProc@@YGJPAUHWND__@@IIJ@Z)
WinMain.obj : error LNK2019: unresolved external symbol __imp__PostQuitMessage@4 referenced in function "long __stdcall MainWndProc(struct HWND__ *,unsigned int,unsigned int,long)" (?MainWndProc@@YGJPAUHWND__@@IIJ@Z)
WinMain.obj : error LNK2019: unresolved external symbol __imp__RegisterClassExW@4 referenced in function _WinMain@16
WinMain.obj : error LNK2019: unresolved external symbol __imp__CreateWindowExW@48 referenced in function _WinMain@16
WinMain.obj : error LNK2019: unresolved external symbol __imp__ShowWindow@8 referenced in function _WinMain@16
C:\source\StarTrekArmada\src\Output\NewArmada.exe : fatal error LNK1120: 8 unresolved externals

Build finished with error(s).

配置文件 #

tasks.json #

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "cppbuild",
            "label": "Build with Microsoft (R) MSVC C/C++ Version 19.35.32217.1 for x86",
            "command": "cl.exe",
            "args": [
                "/Zi",
                "/MT",
                "/MTd",
                "/O2",
                "/EHsc",
                "/nologo",
                "/std:c++20",
                "/Fe${fileDirname}/Output/NewArmada.exe",
                "${workspaceFolder}/src/*.cpp"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$msCompile"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "compiler: cl.exe"
        }
    ]
}

c_cpp_properties.json #

{
    "configurations": [
        {
            "name": "Win32",
            "includePath": [
                "${workspaceFolder}/src/include/**"
            ],
            "defines": [
                "_DEBUG",
                "UNICODE",
                "_UNICODE"
            ],
            "windowsSdkVersion": "10.0.22000.0",
            "compilerPath": "cl.exe",
            "cStandard": "c17",
            "cppStandard": "c++20",
            "intelliSenseMode": "windows-msvc-x64"
        }
    ],
    "version": 4
}

程序代码 #

//
// Main entry point to the program.
//
#include <windows.h>

LRESULT CALLBACK MainWndProc(HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam);

int APIENTRY WinMain(
    _In_ HINSTANCE hInstance,
    _In_opt_ HINSTANCE hPrevInstance,
    _In_ LPSTR cmdLine,
    _In_ int cmdShow
)
{
    const wchar_t* pClassName = L"Test Class Name";

    WNDCLASSEXW wc = { 0 };
    wc.cbSize = sizeof(wc);
    wc.style = CS_OWNDC;
    wc.lpfnWndProc = MainWndProc;  // WindProc Not Yet Define
    wc.cbClsExtra = 0;
    wc.cbWndExtra = 0;
    wc.hInstance = hInstance;
    wc.hIcon = nullptr;
    wc.hCursor = nullptr;
    wc.hbrBackground = nullptr;
    wc.lpszMenuName = nullptr;
    wc.lpszClassName = pClassName; // Must be prefixed with "L" because Microsoft
    wc.hIconSm = nullptr;

    // Register Window Class
    RegisterClassExW(&wc);
    HWND hwnd = CreateWindowExW(
        0,
        pClassName,
        L"Test Window",
        WS_OVERLAPPEDWINDOW,
        CW_USEDEFAULT,
        CW_USEDEFAULT,
        CW_USEDEFAULT,
        CW_USEDEFAULT,
        nullptr,
        nullptr,
        hInstance,
        nullptr
    );

    if(hwnd == NULL)
    {
        return 0;
    }
    ShowWindow(hwnd, SW_SHOW);

    while(true)
    {
        MSG msg;
        if (PeekMessageW(&msg, NULL, 0, 0, PM_REMOVE))
        {
            if (msg.message == WM_QUIT)
            {
                break;
            }
            else
            {
                TranslateMessage(&msg);
                DispatchMessageW(&msg);
            }
        }
    }
    
    return 1;
}
 
LRESULT CALLBACK MainWndProc(HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam)
{
    switch(msg)
    {
        case WM_DESTROY:
            PostQuitMessage(0);
            return 0;
    }

    // If we reach here, we have nothing left we wish to do, so let 
    // Windows handle it. 
    return  DefWindowProc(hWnd, msg, wParam, lParam);
}

解决方案 #

问题出在链接器配置缺失，需要对tasks.json的编译参数做以下修改：

1. 链接Win32系统库：添加user32.lib，因为报错的所有API都属于User32库，必须显式告诉链接器链接该库。
2. 修正运行时库冲突：移除/MT或/MTd中的一个，避免参数覆盖警告。调试阶段建议保留/MTd，发布阶段用/MT。
3. 指定Windows子系统：添加/SUBSYSTEM:WINDOWS，明确程序类型为Windows桌面应用，入口函数为WinMain而非控制台程序的main。

修改后的tasks.json示例：

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "cppbuild",
            "label": "Build with Microsoft (R) MSVC C/C++ Version 19.35.32217.1 for x86",
            "command": "cl.exe",
            "args": [
                "/Zi",
                "/MTd", // 保留调试版静态运行时库，移除冲突的/MT
                "/O2",
                "/EHsc",
                "/nologo",
                "/std:c++20",
                "/SUBSYSTEM:WINDOWS", // 指定Windows子系统
                "/Fe${fileDirname}/Output/NewArmada.exe",
                "${workspaceFolder}/src/*.cpp",
                "user32.lib" // 链接User32库
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$msCompile"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "compiler: cl.exe"
        }
    ]
}

修改后重新执行构建任务，即可解决未解析外部符号的问题，成功生成可执行文件。

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