mac 安装 dotnet 环境

目录

一、安装准备

二、安装方法（两种任选）

[方法 1：使用官方安装包（推荐新手）](#方法 1：使用官方安装包（推荐新手）)

[方法 2：使用 Homebrew（适合开发者）](#方法 2：使用 Homebrew（适合开发者）)

[1. 安装 Homebrew（如未安装）](#1. 安装 Homebrew（如未安装）)

[2. 通过 Homebrew 安装 .NET SDK](#2. 通过 Homebrew 安装 .NET SDK)

[3. 验证安装](#3. 验证安装)

三、多版本管理（可选）

[1. 安装指定版本](#1. 安装指定版本)

[2. 换版本](#2. 换版本)

四、常见问题解决

1.命令未找到 (dotnet: command not found)

2.安装失败（权限问题）

[3.卸载 .NET](#3.卸载 .NET)

---

一、安装准备

1. 确认系统版本

   • 打开终端，输入 sw_vers 查看 macOS 版本。

   • .NET 7/8 要求 macOS 10.15 (Catalina) 或更高版本，旧版需降级安装（如 .NET 6 支持 macOS 10.13+）。

2. 安装依赖工具

   • 确保已安装 Xcode 命令行工具（用于编译）：

   xcode-select --install

---

二、安装方法（两种任选）

方法 1：使用官方安装包（推荐新手）

1. 下载安装包

   • 访问 .NET 官网下载页，选择 macOS 对应的 SDK（开发环境）或 Runtime（仅运行环境）。

   • 推荐下载 .NET SDK（包含运行时和开发工具）。

2. 运行安装程序

   • 双击下载的 .pkg 文件，按向导完成安装。

3. 验证安装

   打开终端，输入：

   dotnet --version

输出版本号（如 8.0.100）即表示成功。

---

方法 2：使用 Homebrew（适合开发者）

1. 安装 Homebrew（如未安装）

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 通过 Homebrew 安装 .NET SDK

brew install --cask dotnet-sdk

3. 验证安装

dotnet --list-sdks

---

三、多版本管理（可选）

若需同时安装多个 .NET 版本，可使用以下方法：

1. 安装指定版本

• 通过 Homebrew 安装旧版：

  brew install dotnet-sdk@7

2. 换版本

• 使用 global.json 文件指定项目使用的版本：

  dotnet new globaljson --sdk-version 7.0.100

四、常见问题解决

1.命令未找到 (dotnet: command not found)

• 检查环境变量：

  echo $PATH

• 确保包含 /usr/local/share/dotnet/。

• 重启终端或执行：

  source ~/.zshrc # 或 ~/.bash_profile

2.安装失败（权限问题）

• 使用 sudo 提权：

  sudo installer -pkg /path/to/package.pkg -target /

3.卸载 .NET

• 删除安装目录：

  sudo rm -rf /usr/local/share/dotnet/
  sudo rm -rf /etc/paths.d/dotnet