嗨，这个场景我之前帮团队处理过类似的，给你几个实用的方案，都是在VS2017里能直接落地的：

方案一：条件编译 + 条件引用（快速落地） #

这是最直接的方式，适合快速切换版本，不需要大规模重构代码：

1. 定义编译符号
   打开项目属性 → 「生成」选项卡 → 在「条件编译符号」里添加：

   • 针对1.0版本：LIBRARY_V1
   • 针对2.0版本：LIBRARY_V2
     更高效的方式是用配置管理器创建不同的解决方案配置（比如Debug_V1、Release_V1、Debug_V2、Release_V2），每个配置对应不同的编译符号，这样切换配置就能自动切换类库版本。

2. 修改项目文件添加条件引用
   右键项目 → 「卸载项目」→ 右键编辑.csproj文件，添加条件引用：

   • 如果是NuGet包：

     <ItemGroup Condition=" '$(DefineConstants)' Contains('LIBRARY_V1') ">
       <PackageReference Include="YourLibraryName" Version="1.0.0" />
     </ItemGroup>
     <ItemGroup Condition=" '$(DefineConstants)' Contains('LIBRARY_V2') ">
       <PackageReference Include="YourLibraryName" Version="2.0.0" />
     </ItemGroup>
     

   • 如果是本地dll：

     <Reference Condition=" '$(DefineConstants)' Contains('LIBRARY_V1') " Include="YourLibrary, Version=1.0.0.0, Culture=neutral, PublicKeyToken=xxx, processorArchitecture=MSIL">
       <HintPath>..\Libs\v1\YourLibrary.dll</HintPath>
     </Reference>
     <Reference Condition=" '$(DefineConstants)' Contains('LIBRARY_V2') " Include="YourLibrary, Version=2.0.0.0, Culture=neutral, PublicKeyToken=xxx, processorArchitecture=MSIL">
       <HintPath>..\Libs\v2\YourLibrary.dll</HintPath>
     </Reference>
     

   保存后重新加载项目即可。

3. 代码中处理API差异
   在调用类库API的地方，用条件编译区分版本逻辑：

   #if LIBRARY_V1
       var device = new OldDeviceApi();
       device.ConnectLegacy(); // 1.0版本专属API
   #elif LIBRARY_V2
       var device = new NewDeviceApi();
       device.ConnectModern(); // 2.0版本专属API
   #endif
   

方案二：抽象层 + 依赖注入（长期维护首选） #

如果项目需要长期迭代，不想在业务代码里到处插条件编译，推荐这种更优雅的方式：

1. 定义抽象接口
   创建一个统一的接口，封装硬件操作的核心方法，完全屏蔽版本差异：

   public interface IDeviceService
   {
       void Connect();
       void SendData(byte[] data);
       // 其他核心业务操作
   }
   

2. 实现不同版本的服务类
   分别针对1.0和2.0版本实现接口，把版本差异封装在实现类内部：

   // 适配1.0版本的实现
   public class DeviceServiceV1 : IDeviceService
   {
       public void Connect()
       {
           var device = new OldDeviceApi();
           device.ConnectLegacy();
       }
   
       public void SendData(byte[] data)
       {
           // 调用1.0版本的Send方法
       }
   }
   
   // 适配2.0版本的实现
   public class DeviceServiceV2 : IDeviceService
   {
       public void Connect()
       {
           var device = new NewDeviceApi();
           device.ConnectModern();
       }
   
       public void SendData(byte[] data)
       {
           // 调用2.0版本的Send方法
       }
   }
   

3. 根据版本注入对应的实现
   在项目初始化时，根据编译符号或配置文件选择对应的服务：

   IDeviceService deviceService;
   #if LIBRARY_V1
       deviceService = new DeviceServiceV1();
   #elif LIBRARY_V2
       deviceService = new DeviceServiceV2();
   #endif
   
   // 业务代码只依赖IDeviceService，完全不用关心底层类库版本
   deviceService.Connect();
   

   也可以用DI容器（比如Autofac、Unity）来管理实现类，后续切换版本会更灵活。

实用注意事项 #

• 切换版本后，记得先清理解决方案（「生成」→「清理解决方案」）再重新生成，避免旧dll残留导致的版本冲突；
• 如果有测试项目或依赖项目，要同步配置对应的编译符号和类库引用；
• 本地dll建议放在项目目录下的子文件夹（比如Libs/v1、Libs/v2），避免不同版本的文件混淆；
• NuGet包如果出现版本异常，可以清理VS的NuGet缓存（「工具」→「NuGet包管理器」→「管理解决方案的NuGet包」→「设置」→「清除所有NuGet缓存」）。

我个人更推荐方案二，虽然前期需要花点时间做抽象，但后期维护成本极低，业务代码完全不用关心底层类库的版本差异。如果赶进度，方案一可以快速解决问题。

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