如何让Visual Studio识别CPack生成的C++ NuGet包的头文件与库？

核心原因 #

NuGet包要让Visual Studio自动配置包含目录、库目录和链接依赖，必须包含.targets和.props元数据文件——这些文件是VS识别原生C++包构建配置的关键，你的当前配置仅打包了文件，未提供这类元数据。

具体解决方案 #

1. 编写NuGet所需的元数据文件 #

在项目根目录创建nuget文件夹，添加以下两个文件（注意替换<PackageName>为你的CPACK_PACKAGE_NAME值，你的库文件名.lib为实际库文件名）：

.props（配置头文件路径）

<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
    <_PackageFolder>$([System.IO.Path]::GetFullPath('$(MSBuildThisFileDirectory)..\'))</_PackageFolder>
  </PropertyGroup>
  <ItemDefinitionGroup>
    <ClCompile>
      <AdditionalIncludeDirectories>$(_PackageFolder)include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
    </ClCompile>
  </ItemDefinitionGroup>
</Project>

.targets（配置库路径和链接依赖）

<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
    <_PackageFolder>$([System.IO.Path]::GetFullPath('$(MSBuildThisFileDirectory)..\'))</_PackageFolder>
  </PropertyGroup>
  <ItemDefinitionGroup>
    <Link>
      <AdditionalLibraryDirectories>$(_PackageFolder)lib\$(Platform)\$(Configuration);%(AdditionalLibraryDirectories)</AdditionalLibraryDirectories>
      <AdditionalDependencies>你的库文件名.lib;%(AdditionalDependencies)</AdditionalDependencies>
    </Link>
  </ItemDefinitionGroup>
</Project>

2. 在CMake中配置安装元数据文件 #

在CMakeLists.txt中添加安装指令，将元数据文件安装到NuGet包的标准原生配置目录build/native：

# 安装NuGet元数据文件
install(
    FILES nuget/${CPACK_PACKAGE_NAME}.props nuget/${CPACK_PACKAGE_NAME}.targets
    DESTINATION build/native
)

3. 配置CPack NuGet专属变量 #

设置CPack变量，让NuGet识别元数据文件的位置：

# 指定Nu包的构建配置文件路径
set(CPACK_NUGET_BUILD_PROPS_FILE build/native/${CPACK_PACKAGE_NAME}.props)
set(CPACK_NUGET_BUILD_TARGETS_FILE build/native/${CPACK_PACKAGE_NAME}.targets)

# 设置框架兼容性（原生C++包填"native"即可）
set(CPACK_NUGET_FRAMEWORK_COMPATIBILITY "native")

4. 重新生成包 #

执行原有构建打包命令即可：

cmake -S . -B build
cmake --build build --config Release
cd build
cpack -G NuGet -C 'Release'

额外注意事项 #

• 若你的库支持多平台（x86/x64）或多配置（Debug/Release），.targets文件中的$(Platform)和$(Configuration)变量会自动适配，确保库路径与实际安装结构匹配。
• 可将生成的.nupkg文件改后缀为.zip，检查内部结构：确认build/native目录存在元数据文件，include和lib目录位置与元数据文件中的路径对应。

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