.NET Core Support

The following table describes the versions of .NET Core supported by the stable and preview versions of Visual Studio for Mac:

.NET Core SDK Version Visual Studio for Mac 8.1 Visual Studio for Mac 8.2 Visual Studio for Mac 8.3 Visual Studio for Mac 8.4 Visual Studio for Mac 8.5 Visual Studio for Mac 8.6
v2.1.0 - v2.1.5xx
v2.1.600 + ✔︎ ✔︎ ✔︎ ✔︎ ✔︎ ✔︎
v2.2.1 - v2.2.1xx
v2.2.200 + ✔︎ ✔︎ ✔︎ ✔︎ ✔︎ ✔︎
v3.0 ✔︎ ✔︎ ✔︎ ✔︎
v3.1 ✔︎ ✔︎ ✔︎
v5.0 ✔︎


Preview versions of the .NET Core SDK are not supported; please update to the released version. When installing Visual Studio for Mac 8.4, the released version of .NET Core v3.1 will be installed.


If you were previously using .NET Core v2.2.1xx with Visual Studio for Mac 8.0, you'll need to manually update to a supported version of .NET Core, as listed in the table above. We recommend either 2.1.700 or 2.2.300

  • .NET Core v3.1 is installed by default for 8.4, 8.5 and 8.6.
  • .NET Core v3.0 is installed by default for 8.3.
  • .NET Core v2.1.701 (v2.1.700 for 8.1) is installed by default with the installer.
  • To download any other version of .NET Core, visit the dotnet page.
  • When using .NET Core 3.0, C# version 8 will be used by default. C# 7.3 is default when using .NET Core 2.x. See C# language versioning for more info.
  • For information on installing a preview version of Visual Studio for Mac, see the Install a Preview Release guide.