使用Boost.Python封装C++函数遇LNK1104错误，同配置示例正常？

在使用boost::python封装C++函数时，出现链接错误：LNK1104 无法打开“libboost_python39-vc142-mt-sgd-x64-1_82.lib”。
但在相同的Visual Studio 2019配置下，编译另一段简单示例代码却能成功运行，成功代码如下：

#define BOOST_PYTHON_STATIC_LIB

#include <boost/python.hpp>
#include "SomeClass.h"
using namespace boost::python;

BOOST_PYTHON_MODULE(member)
{
    class_<SomeClass>("SomeClass", init<std::string>())
        .def_readwrite("name", &SomeClass::name)
        .def("getNumber", &SomeClass::getNumber)
        .def("setNumber", &SomeClass::setNumber)
        ;
}

请问为何相同配置下，两段代码会出现不同的编译结果？

以下是可能导致该差异的几个核心原因及对应解决方法：

• BOOST_PYTHON_STATIC_LIB宏定义位置错误
  成功的代码在最开头就定义了#define BOOST_PYTHON_STATIC_LIB，这个宏会告诉Boost使用静态链接版本的库。如果你的出错代码中，这个宏定义在#include <boost/python.hpp>之后，或者根本没定义，编译器会默认尝试链接动态库，而你当前环境只有静态库可用，就会触发LNK1104错误。
  解决：确保BOOST_PYTHON_STATIC_LIB定义在所有Boost头文件包含之前。

• 代码使用了额外的Boost Python组件
  你的出错代码可能用到了成功代码中没有的Boost Python功能（比如numpy绑定、自定义类型转换器、高级对象封装等），这些功能依赖额外的静态库文件，而你当前的库目录中缺少对应的libboost_python39-xxx.lib变体，或者库的命名、版本与项目要求不匹配。
  解决：检查出错代码中调用的Boost Python API，确认是否需要额外库支持，同时验证Boost库的版本、编译参数（MT/SGD、x64、VC版本）是否与当前项目完全一致。

• 项目配置存在隐性差异
  即使你认为配置相同，也可能存在细节偏差：

  • 成功项目的附加库目录包含了该缺失库的路径，而出错项目没有；
  • 成功项目的链接器->输入手动指定了正确的库名，而出错项目依赖自动链接但路径不对；
  • 两个项目的运行库设置不一致（比如一个是多线程调试(/MTd)，另一个是多线程(/MT)），导致需要的库后缀不匹配。
    解决：对比两个项目的所有配置项，重点检查C/C++->常规->附加包含目录、链接器->常规->附加库目录、C/C++->代码生成->运行库这几个选项，确保完全一致。

• Boost库编译不完整
  你编译的Boost库可能缺少sgd后缀对应的版本（Boost库命名中mt-sgd对应多线程、静态链接、调试版本的运行库配置）。成功代码刚好没有用到需要这个变体的功能，所以能编译通过，而出错代码触发了对该库的依赖。
  解决：重新编译Boost库，确保生成对应mt-sgd-x64版本的boost_python库，或者调整项目的运行库设置，匹配已有的Boost库版本。

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