返回指南

如何为你的插件选择正确的 CounterStrikeSharp.API 版本

有些插件会直接在项目文件中固定一个确切的 CounterStrikeSharp.API 版本，而不仅仅是声明一个 .NET 版本。当这种情况发生时，我们的编译器会在编译前显示一个带有三个按钮的提示，当前、较新和最新，每个都指向不同的版本。选错选项是插件能顺利编译却无法启动，或启动后表现异常的常见原因。

为什么你会看到这个提示

插件作者在编写时将项目锁定到某个特定的 CounterStrikeSharp.API 版本，很可能是因为那正是他们测试所用的版本。我们的编译器会检测到这一点，并请你确认实际要使用哪个版本，而不是默默地替你选择一个。

当前：插件构建时所用的版本

当前 X.Y.Z（.NET 8.0）

这会使用插件作者固定的确切版本进行编译，使用该版本所要求的确切 .NET 版本。这是我们推荐的选项，尤其是当你不熟悉插件代码、无法轻易判断它是否会在更新的 API 上出问题时。这是插件实际测试所用的版本。

较新：相同的 .NET，更新的 CounterStrikeSharp.API

较新 X.Y.Z（.NET 8.0）

这会保持插件所面向的相同 .NET 版本，但会针对该 .NET 版本可用的最新 CounterStrikeSharp.API 版本进行编译。这通常可以正常工作，CounterStrikeSharp.API 的更新通常是向后兼容的，但并非总是如此。

风险：如果插件所依赖的某个方法在版本之间发生了变化或被移除，插件可能编译时没有报错，却仍然加载失败，或者在你的服务器上运行时行为不正确。

最新：可用的最新 .NET 和 CounterStrikeSharp.API

最新 X.Y.Z（.NET 10.0）

这完全忽略插件最初所面向的目标，直接针对我们所拥有的最新 .NET 版本和最新 CounterStrikeSharp.API 版本进行编译，无论当前是什么组合。对于较旧的插件来说，这通常是比"较新"更大的跨度，.NET 版本和 API 本身都可能已经发生变化。

风险：实际上，这个选项最常见的结果是让为旧版 CounterStrikeSharp.API 编写的旧插件出现编译错误，而不是得到一个带有细微 bug、但能运行的插件。只有当你明确知道该插件已更新以支持最新版本，或者你已准备好自己修复编译错误时，才应该选择它。

我们的建议

除非你有特定理由，否则请选择"当前"。它与插件实际构建和测试所用的环境相匹配，因此是最不可能出现"编译顺利、之后却以难以诊断的方式失败"这种情况的选项。只有在你确实需要某个较新 CounterStrikeSharp.API 版本中的功能，并且准备好在之后彻底测试插件（而不只是确认它能编译通过）时，才考虑使用"较新"或"最新"。

这篇教程对你有帮助吗？

CounterStrikeSharp - Getting Started Guide - NuGet Package - GitHub - Cookie 政策 - IceGame Romania

页面生成耗时 0.011 秒

CounterStrikeSharp Web Compiler V1.0 - 制作工具由 Barlap 为社区打造。