如何通过NuGet复制Razor类库特定文件夹及用dotnet pack打包Areas文件夹

阿华AIGC实验室

2026-5-11

我来帮你搞定这个问题——在.NET 5的Razor类库中打包Areas文件夹，并且让它在安装NuGet包时自动原封不动地复制到目标项目里，核心是通过项目文件配置告诉NuGet该怎么处理这些文件，步骤很清晰：

1. 配置Razor类库的项目文件（.csproj）

这是最关键的一步，你需要在项目文件里添加配置，让NuGet把Areas文件夹及其所有子文件都包含进包，并且指定安装时的目标位置。

打开你的Razor类库项目的.csproj文件，添加下面的ItemGroup节点：

<ItemGroup>
  <!-- 匹配Areas文件夹下所有层级的文件 -->
  <Content Include="Areas\**\*" Pack="true">
    <!-- 指定文件在NuGet包内的存放路径，contentFiles是NuGet用于内容文件的标准目录 -->
    <PackagePath>contentFiles/any/any/Areas</PackagePath>
    <!-- 确保文件复制到输出目录 -->
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <!-- 确保文件复制到发布目录 -->
    <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
    <!-- 明确标记要包含进NuGet包 -->
    <IncludeInPackage>true</IncludeInPackage>
  </Content>
</ItemGroup>

简单解释下这些属性：

Include="Areas\**\*"：通配符匹配Areas下所有文件和子文件夹
Pack="true"：告诉NuGet这些文件要被打包
PackagePath="contentFiles/any/any/Areas"：contentFiles/any/any是NuGet的通用路径，适配所有目标框架和平台，最后面的Areas就是安装时要复制到目标项目根目录的文件夹名称
CopyToOutputDirectory和CopyToPublishDirectory：确保文件在构建和发布时能被正确复制

2. 用dotnet pack命令打包整个Areas文件夹

配置完成后，就可以用dotnet命令行来打包了，步骤如下：

先清理并编译项目（确保是Release版本）：
```
dotnet clean
dotnet build -c Release
```
执行打包命令，指定输出目录方便查找生成的NuGet包：
```
dotnet pack -c Release --output ./nupkgs
```
这个命令会在项目根目录下生成一个nupkgs文件夹，里面就是你的NuGet包文件（.nupkg格式）。

3. 验证打包效果

你可以做两个验证确保没问题：

用NuGet Package Explorer打开生成的.nupkg文件，查看contentFiles/any/any/Areas目录下是否包含了你所有的文件和子结构
创建一个测试的ASP.NET Core项目，安装这个NuGet包，看看项目根目录是否自动出现了完整的Areas文件夹和对应文件

额外注意点

确保Areas文件夹里的所有文件的Build Action都是Content（右键文件→属性里可以设置），否则NuGet可能不会打包这些文件
如果你的Razor类库是用于组件的，不要混淆组件的EmbeddedResource设置，这里我们针对的是要复制到目标项目的内容文件，所以必须用Content类型

这样操作下来，你的NuGet包安装后，Areas文件夹就会原封不动地出现在目标项目里了。

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