MacOS运行ASP.NET Core后端API：替代IIS Express的配置咨询

首选替代方案：使用Kestrel服务器 #

ASP.NET Core本身是跨平台框架，Kestrel是它的内置跨平台Web服务器，完全可以替代Windows上的IIS Express，这是最直接的方案，不需要额外安装复杂服务。

需要调整的配置项 #

1. 修正launchSettings.json配置 #

项目根目录下Properties/launchSettings.json里保留的IIS Express配置不会影响Mac运行，但要确保Kestrel的配置正确：

• 找到profiles下的[项目名]节点（对应Kestrel启动项），确认applicationUrl包含HTTP和HTTPS本地地址，示例：

  "applicationUrl": "https://localhost:5001;http://localhost:5000",
  "environmentVariables": {
    "ASPNETCORE_ENVIRONMENT": "Development"
  }
  

• 如果没有这个节点，直接新增一个，commandName设为Project即可。

2. 移除/替换Windows特定依赖 #

• 若项目引用了Microsoft.AspNetCore.Server.IISIntegration这类仅IIS需要的NuGet包，可选择移除（Kestrel不需要），保留也不会影响Mac运行，只是冗余。
• 检查代码中是否有Windows专属API调用（比如System.DirectoryServices、注册表操作等），这类代码需替换为跨平台实现，否则Mac上会报错。

3. 配置HTTPS开发证书 #

Mac上ASP.NET Core会自动生成开发用HTTPS证书，但默认不被系统信任，终端运行以下命令完成信任：

dotnet dev-certs https --trust

弹出系统提示后点击信任即可。

运行项目的步骤 #

1. 安装对应版本的.NET SDK：确保Mac上的.NET SDK版本和项目目标框架一致，用dotnet --version查看当前版本。
2. 恢复项目依赖：终端进入项目根目录，运行：

   dotnet restore
   

3. 启动项目：直接运行命令启动Kestrel：

   dotnet run
   

   也可以用VS Code/Rider这类IDE，选择Kestrel启动配置直接启动。

常见问题处理 #

• 端口占用：默认5000/5001端口被占用时，临时指定端口启动：

  dotnet run --urls "http://localhost:5002;https://localhost:5003"
  

  或者修改launchSettings.json里的applicationUrl永久更换端口。
• 文件路径问题：代码中硬编码的Windows风格路径（比如C:\xxx\file.txt），要改成跨平台写法，比如用Path.Combine或斜杠/。

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