GitHub上的Newtonsoft.Json v11与NuGet v13是否一致？修改版本号可行吗？

临时场景下的有效性 #

把本地fork的Newtonsoft.Json程序集版本改成13，临时用是能跑起来的——.NET的程序集加载机制会优先匹配版本号，只要你的自定义版本号符合依赖包（比如Quartz）的要求，就能跳过版本检查，正常加载。

必须注意的风险 #

• API兼容性问题：Newtonsoft.Json v11和v13之间有不少API新增、行为变更（比如日期序列化逻辑、异步API优化等）。依赖v13的包可能调用v11没有的API，运行时会直接抛出MissingMethodException，或者依赖v13特有行为导致逻辑错误。
• 版本管理混乱：后续引入其他依赖Newtonsoft.Json的包时，不同版本要求会和你伪造的v13产生冲突，绑定重定向配置会变得异常复杂，排查加载问题会很麻烦。
• 长期维护成本高：以后要同步官方更新时，每次都得重新修改版本号，还得处理版本字段的合并冲突，得不偿失。

更稳妥的替代方案 #

• 用绑定重定向规避版本要求：在项目配置文件（app.config/web.config）里添加绑定重定向，把所有对v13的依赖指向你的自定义v11版本。示例：

  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
        <assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-13.0.0.0" newVersion="11.0.0.0" />
      </dependentAssembly>
    </assemblyBinding>
  </runtime>
  

  只要你的自定义v11能兼容依赖包的API，这种方式完全不用改版本号。
• 基于官方v13分支开发：直接切换到Newtonsoft.Json官方的v13分支做fork和功能开发，原生版本号就是v13，完美匹配依赖要求，还能继承v13的所有特性，避免版本伪造的风险。

内容的提问来源于stack exchange，提问作者Camillo Cardoso Borges