如何在.NET 4.7.1的ASP.NET MVC 5 Razor视图中引用netstandard 2.0类型？

我之前也碰到过一模一样的问题——.NET 4.7.1明明宣称原生支持netstandard 2.0，但在MVC5的Razor视图里引用相关类型时，要么弹出一堆DLL冲突警告，要么干脆运行时找不到类型。核心问题其实出在老项目的packages.config依赖管理方式上，换成PackageReferences之后大部分问题都能解决，下面是我亲测有效的完整步骤：

1. 先把项目迁移到PackageReferences #

这是解决依赖冲突的关键一步，PackageReferences比老的packages.config要智能得多，能自动处理依赖树的版本统一，减少手动维护的麻烦。

• 手动迁移方案（最可靠）：

  • 先备份你的.csproj项目文件和packages.config，以防操作失误回滚。
  • 右键项目→选择「编辑.csproj」，删除所有和packages.config相关的节点：比如指向NuGet.targets的<Import>节点，还有所有<Reference>里指向本地packages目录的引用。
  • 把原来的NuGet包换成PackageReferences格式：每个包对应一行<PackageReference Include="包名" Version="版本号" />，比如MVC5的核心包就写<PackageReference Include="Microsoft.AspNet.Mvc" Version="5.2.9" />。
  • 删除项目根目录的packages.config文件，然后重新加载项目，VS会自动把包还原到全局缓存，不用再维护本地packages文件夹。

• 偷懒小技巧：如果项目包不多，可以试试VS自带的迁移工具：右键项目→「管理NuGet包」→点击右上角齿轮图标→选择「迁移packages.config到PackageReference」，跟着向导走就行。如果迁移失败，再手动调整项目文件。

2. 让Razor视图识别netstandard类型 #

迁移完依赖后，还要确保Razor视图能正确找到netstandard 2.0的类型：

• 先确认你的netstandard2.0类库已经通过PackageReference引用到MVC项目里。
• 修改项目根目录的Web.config：找到<system.web/compilation>节点，确保targetFramework是4.7.1，并添加netstandard的程序集引用：

  <compilation debug="true" targetFramework="4.7.1">
    <assemblies>
      <add assembly="netstandard, Version=2.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51" />
    </assemblies>
  </compilation>
  

• 修改Views文件夹下的Web.config：在<system.web.webPages.razor/pages/namespaces>里添加你的netstandard类库命名空间，这样视图里就不用每次都写@using了：

  <pages pageBaseType="System.Web.Mvc.WebViewPage">
    <namespaces>
      <add namespace="你的NetStandard类库命名空间" />
    </namespaces>
  </pages>
  

3. 清理DLL冲突和绑定重定向 #

即使迁移到PackageReferences，偶尔还是会碰到版本冲突警告，这时候可以这么处理：

• 打开项目根目录的Web.config，找到<runtime/assemblyBinding>节点，删掉所有重复或过时的<dependentAssembly>条目。
• 让VS自动生成正确的绑定重定向：右键项目→「属性」→「生成」→勾选「自动生成绑定重定向」，然后重新生成项目，VS会自动把必要的重定向规则添加到Web.config里。
• 如果还是有顽固警告，打开Package Manager Console运行Update-Package -reinstall，这会重新安装所有包并强制统一版本。

4. 验证效果 #

最后在Razor视图里写点测试代码验证一下，比如：

@model 你的NetStandard类库.Models.UserModel
@{
    var testObject = new 你的NetStandard类库.Helpers.TestHelper();
}

重新生成项目，如果没有编译错误，运行项目访问该视图，确认没有运行时异常就大功告成了。

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