构建Visual Studio 2022 C++静态库未生成.lib文件的问题排查

生成.lib文件的核心必要条件 #

• 项目类型正确配置：必须将项目属性→配置属性→常规→配置类型设置为「静态库(.lib)」，而非应用程序或其他类型。
• 存在可编译的代码文件：静态库是编译后目标文件(.obj)的集合，仅包含头文件(.h/.hpp)的话，编译器没有可编译的实现代码，不会生成.lib——头文件仅作声明，不产生可执行的二进制代码。
• 配置与平台匹配：确保当前构建的配置(Debug/Release)、平台(x86/x64)和引用该库的项目完全一致，避免因路径或版本不匹配找不到文件。
• 输出路径有效：检查项目属性→链接器→常规→输出文件的路径是否正确，且当前用户对该路径有读写权限。

你的问题根源及修复方案 #

你的Commons项目只有logger_mutex.h头文件，没有对应的.cpp编译单元。即便头文件里定义了std::mutex loggerMutex，头文件本身不会被编译成.obj，没有.obj就无法打包生成.lib文件——这和代码量多少无关，关键是缺少可编译的代码文件。

修复步骤：

1. 在Commons项目中新增一个.cpp文件（比如logger_mutex.cpp），内容只需包含头文件即可：

   #include "logger_mutex.h"
   

2. 重新构建Commons项目，此时输出目录会生成对应配置的.lib文件（Debug模式下通常是Commonsd.lib）。
3. 确认引用该库的项目配置、平台与Commons完全一致，再重新构建整个解决方案，即可解决LINK1104错误。

额外提醒：不要在头文件中直接定义全局变量（如你的std::mutex loggerMutex），否则多个项目包含该头文件会触发重定义错误。正确做法是在头文件中用extern声明变量：

// logger_mutex.h
#ifdef _DEBUG
#include <mutex>
extern std::mutex loggerMutex;
#endif

然后在.cpp文件中定义：

// logger_mutex.cpp
#ifdef _DEBUG
#include "logger_mutex.h"
std::mutex loggerMutex;
#endif

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