如何阻止C#项目安装指定版本以上NuGet包时编译？

一、编译时阻止版本升级（推荐） #

通过MSBuild自定义目标或NuGet原生版本约束，在编译阶段直接终止不符合要求的版本使用。

1. 双重限制：NuGet版本约束+MSBuild编译检查 #

• 第一步：锁定允许的版本范围
  在项目文件（.csproj）中修改PackageReference，添加AllowedVersions属性，限定只能使用指定版本：

  <PackageReference Include="Newtonsoft.Json" Version="12.0.3" AllowedVersions="[12.0.3]" />
  

  这个设置会让NuGet包管理器默认无法升级到13.*版本，但如果开发者手动修改.csproj的版本号仍能绕过，因此需要配合编译检查。

• 第二步：添加MSBuild编译检查目标
  在.csproj中添加自定义Target，在编译前检查包版本，不符合则抛出编译错误：

  <Target Name="EnforceNewtonsoftJsonVersion" BeforeTargets="Compile">
    <GetPackageReferences Include="Newtonsoft.Json">
      <Output TaskParameter="PackageReferences" ItemName="TargetPackage" />
    </GetPackageReferences>
    <PropertyGroup>
      <RequiredVersion>12.0.3</RequiredVersion>
    </PropertyGroup>
    <Error Condition="'%(TargetPackage.Version)' != '$(RequiredVersion)'"
           Text="错误：Newtonsoft.Json必须使用版本$(RequiredVersion)，当前版本为%(TargetPackage.Version)，请回滚版本。" />
  </Target>
  

  只要版本不符合，Visual Studio编译时会直接弹出错误并终止流程，开发者必须回滚到指定版本才能继续开发。

二、运行时检测并抛出异常 #

如果编译时方案无法覆盖所有场景（比如特殊的包引用方式），可以在程序启动时检查包版本，不符合则抛出运行时异常：

实现代码 #

在程序入口（比如Program.Main）添加检查逻辑：

using System;
using System.Reflection;

namespace YourApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            CheckNewtonsoftVersion();
            // 后续启动逻辑
        }

        private static void CheckNewtonsoftVersion()
        {
            var requiredVersion = new Version("12.0.3");
            Assembly newtonsoftAssembly;
            try
            {
                newtonsoftAssembly = Assembly.Load("Newtonsoft.Json");
            }
            catch (FileNotFoundException)
            {
                throw new InvalidOperationException("未找到Newtonsoft.Json程序集，请确认已安装指定版本的NuGet包。");
            }

            var currentVersion = newtonsoftAssembly.GetName().Version;
            if (currentVersion != requiredVersion)
            {
                throw new InvalidOperationException(
                    $"Newtonsoft.Json版本不符合要求：需要{requiredVersion}，当前为{currentVersion}。请降级到指定版本。");
            }
        }
    }
}

该逻辑会在程序启动时立即执行，一旦检测到版本不匹配，直接抛出异常阻止程序运行，同时给出明确的错误提示。

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