迁移至PackageReference后jQuery文件无法找到的问题排查

为什么会找不到文件？ #

PackageReference 和原来的 packages.config 处理静态资源的逻辑完全不一样：

• 用packages.config时，NuGet会自动把包里的JS、CSS复制到项目的Scripts、Content文件夹里
• 换成PackageReference后，默认不会把这些资源复制到项目目录，它们只存在NuGet的全局缓存里，项目自然找不到

具体怎么解决？ #

1. 别恢复<ProjectTypeGuids>那行（这是关键） #

你迁移后把这行加回去，等于让项目又变回了旧的Web项目模式，PackageReference的逻辑根本没法正常工作。直接删掉这行，保持PackageReference的项目状态。

2. 给项目加配置，让构建时自动复制资源 #

打开你的.csproj文件，添加下面的配置，这样每次构建项目时，会自动把NuGet包里的jQuery文件复制到项目的Scripts文件夹：

<ItemGroup>
  <PackageReference Include="jQuery" Version="你的jQuery版本号">
    <PrivateAssets>all</PrivateAssets>
    <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
  </PackageReference>
</ItemGroup>

<Target Name="CopyNuGetScripts" AfterTargets="Build">
  <Copy SourceFiles="$(NuGetPackageRoot)\jquery\$(PackageVersion)\content\Scripts\jquery-*.js" DestinationFolder="$(ProjectDir)\Scripts" SkipUnchangedFiles="true" />
</Target>

3. 用LibraryManager替代传统NuGet资源管理 #

安装Microsoft.Web.LibraryManager.Build这个NuGet包，它是专门用来管理前端库的工具：

• 在NuGet包管理器里搜这个包安装
• 项目根目录会生成libman.json，你在里面配置需要的jQuery版本和部署目录，构建时它会自动下载并把文件放到指定位置，还能自动更新

4. 最后验证一下 #

• 清理项目，删掉bin、obj文件夹，然后重新构建
• 在视图里用@Scripts.Render("~/Scripts/jquery-xxx.js")或者直接写路径引用就行

内容的提问来源于stack exchange，提问作者Fahmi Ben Salah