使用link.exe构建静态库遇LNK1104错误，求排查解决

问题场景 #

为排查Visual Studio link.exe的相关问题，我将复杂源码简化为header.hxx头文件和impl.cxx实现文件，编写批处理脚本构建静态库，执行命令如下：

call "c:\Program Files (x86)\Microsoft Visual Studio\2019\Professional\VC\Auxiliary\Build\vcvarsall.bat" x64 10.0.22621.0
cl /c /EHsc /nologo /W3 /D "_DEBUG" impl.cxx
link /OUT:"library.lib" /DEBUG /SUBSYSTEM:CONSOLE /NOLOGO /MACHINE:X64 impl.obj

编译过程正常，但链接器报错：

Creating library library.lib and object library.exp
LINK : fatal error LNK1104: cannot open file 'library.lib'

源代码 #

header.hxx

#pragma once

extern __declspec(dllexport) int abc1();

impl.cxx

#include "header.hxx"

extern __declspec(dllexport) int abc1()
{
    return 0;
}

问题分析与解决 #

出现这个错误的核心问题有两个：

• 错误使用link命令生成静态库：默认情况下link.exe用于生成可执行文件（EXE）或动态库（DLL），当你指定输出为.lib时，它会尝试生成可执行文件并自动创建对应的导入库，这和构建静态库的目标冲突。生成静态库需使用/LIB选项，或直接用专门的lib.exe工具。

• 静态库误用__declspec(dllexport)：该修饰符用于标记动态库（DLL）需导出的符号，静态库不需要导出符号（符号会直接被链接到目标程序），添加它会干扰链接器正常逻辑。

修正后的构建命令

保留编译命令不变，将链接命令替换为以下任意一种：

1. 使用link.exe加/LIB选项：

link /LIB /OUT:"library.lib" /NOLOGO /MACHINE:X64 impl.obj

2. 更推荐使用专门的lib.exe工具：

lib /OUT:"library.lib" /NOLOGO impl.obj

修正后的源代码

header.hxx

#pragma once

extern int abc1();

impl.cxx

#include "header.hxx"

int abc1()
{
    return 0;
}

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