如何将从项目提取的sfizz库添加到Visual Studio新项目中？

背景 #

需将sfizz开源库（Windows 64位版本1.2.3）集成到Visual Studio 2017/2019项目中，但配置过程中遇到问题。该库的文件结构如下：

\sfizz-1.2.3-win64\bin\Release
sfizz.dll
sfizz_render.exe
sfizz_tests.exe

\sfizz-1.2.3-win64\lib\Release
absl_bad_optional_access.lib
absl_bad_variant_access.lib
absl_base.lib
...
sfizz_spline.lib
sfizz_static.lib
sfizz_tunings.lib
st_audiofile.lib
st_audiofile_formats.lib

一、前期准备 #

• 将下载的sfizz-1.2.3-win64压缩包解压到不含中文、空格的本地路径，例如D:\libs\sfizz-1.2.3-win64。
• 确认Visual Studio项目的平台为x64：打开项目属性→配置管理器，将活动解决方案平台设为x64。
• 若解压包中无头文件，需从sfizz代码仓库获取对应版本的头文件（如src目录下的.h文件），整理到单独的include文件夹（例如D:\libs\sfizz-1.2.3-win64\include）。

二、配置头文件路径 #

1. 右键项目→属性→配置属性→C/C++→常规→附加包含目录。
2. 添加头文件所在路径：D:\libs\sfizz-1.2.3-win64\include，点击确定保存。

三、配置库文件目录 #

1. 右键项目→属性→配置属性→链接器→常规→附加库目录。
2. 添加库文件路径：D:\libs\sfizz-1.2.3-win64\lib\Release，点击确定保存。

四、配置链接依赖项 #

根据使用动态库或静态库的需求，二选一配置：

动态库模式（推荐） #

1. 右键项目→属性→配置属性→链接器→输入→附加依赖项。
2. 添加sfizz.lib（若解压包中无此文件，需改用静态库模式）。

静态库模式 #

1. 右键项目→属性→配置属性→链接器→输入→附加依赖项。
2. 添加所有必要的库文件：
   sfizz_static.lib、absl_bad_optional_access.lib、absl_bad_variant_access.lib、absl_base.lib、sfizz_spline.lib、sfizz_tunings.lib、st_audiofile.lib、st_audiofile_formats.lib（以及lib目录下其他未列出的依赖库）。
3. 若存在编译宏要求，可在C/C++→预处理器→预处理器定义中添加SFIZZ_STATIC（具体以库文档为准）。

五、处理运行时DLL（仅动态库模式） #

• 将sfizz.dll从D:\libs\sfizz-1.2.3-win64\bin\Release复制到项目的输出目录（如x64\Release）；
• 或把D:\libs\sfizz-1.2.3-win64\bin\Release添加到系统环境变量PATH中，避免运行时提示找不到DLL。

六、测试代码验证 #

在项目中添加以下测试代码，验证配置是否成功：

#include <sfizz.h>
#include <iostream>

int main() {
    sfizz_synth_t* synth = sfizz_create_synth();
    if (synth) {
        std::cout << "sfizz synth 创建成功！" << std::endl;
        sfizz_destroy_synth(synth);
    } else {
        std::cout << "sfizz synth 创建失败！" << std::endl;
    }
    return 0;
}

切换到Release模式编译运行，若输出成功信息则配置完成。

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