M1 MacBook Air上.NET Core开发遇System.IO.Pipe平台不支持异常求助

问题根源 #

.NET Core 3.x及更早版本在非Windows平台（包括ARM架构的macOS）未实现NamedPipeServerStream，导致抛出PlatformNotSupportedException。而Windows原生支持命名管道，所以你的Windows团队成员不会遇到这个问题。

解决方案 #

1. 升级到.NET 5+版本（推荐）

从.NET 5开始，官方完善了跨平台命名管道的支持，ARM架构的macOS也能正常使用NamedPipeServerStream。

• 检查当前.NET SDK版本：运行dotnet --list-sdks
• 安装适配M1的ARM64架构.NET 6/7/8 LTS版本（官网提供对应安装包）
• 更新项目文件（.csproj）的目标框架：

  <TargetFramework>net6.0</TargetFramework> <!-- 替换原有的netcoreapp3.1等旧版本 -->
  

• 执行dotnet restore重新加载依赖，之后即可正常使用命名管道API。

2. 用跨平台IPC方案替代（无法升级.NET版本时）

如果项目无法升级.NET版本，可以使用Unix域套接字（Windows 10 1809+、macOS、Linux均支持）替代命名管道，实现跨平台兼容：

• 服务器端示例代码：

  using System.Runtime.InteropServices;
  using System.IO.Pipes;
  using System.Net.Sockets;
  
  // 跨平台IPC服务器
  var socketIdentifier = RuntimeInformation.IsOSPlatform(OSPlatform.Windows) 
      ? @"\\.\pipe\team-shared-pipe" 
      : "/tmp/team-shared-pipe.sock";
  
  if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
  {
      using var server = new NamedPipeServerStream("team-shared-pipe");
      await server.WaitForConnectionAsync();
      // 处理Windows平台通信逻辑
  }
  else
  {
      using var listener = new UnixDomainSocketListener(socketIdentifier);
      await listener.StartAsync();
      using var socket = await listener.AcceptAsync();
      // 处理macOS平台通信逻辑
  }
  

• 客户端对应使用NamedPipeClientStream（Windows）或UnixDomainSocketClient（非Windows），Windows团队的代码无需修改。

3. 条件编译适配不同平台

通过条件编译指令，为Windows和macOS分别编写适配代码，既保留Windows上的命名管道逻辑，又解决macOS的兼容性问题：

#if WINDOWS
using var server = new NamedPipeServerStream("team-shared-pipe");
await server.WaitForConnectionAsync();
// Windows平台的命名管道处理逻辑
#else
// macOS平台使用Unix域套接字
using var listener = new UnixDomainSocketListener("/tmp/team-shared-pipe.sock");
await listener.StartAsync();
using var socket = await listener.AcceptAsync();
// macOS平台的IPC处理逻辑
#endif

• 在项目文件中添加平台定义：

  <PropertyGroup>
    <DefineConstants Condition="'$(OS)' == 'Windows_NT'">WINDOWS</DefineConstants>
  </PropertyGroup>
  

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