Dart SDK 在 macOS 上未找到需安装或配置环境变量，推荐用 Homebrew 安装；也可手动下载 SDK 并配置 PATH；若已装 Flutter，可直接用 flutter dart 命令；最后需验证 hello.dart 运行成功。
如果您希望在 macOS 系统上运行 Dart 程序，但终端中执行 dart --version 时提示命令未找到，则说明 Dart SDK 尚未安装或环境变量未正确配置。以下是针对 Mac 平台的多种 Dart SDK 安装与配置方法：
一、通过 Homebrew 安装（推荐）
Homebrew 是 macOS 上最主流的包管理工具，可自动处理依赖并简化安装流程。使用它安装 Dart SDK 能确保版本一致性与后续更新便利性。
1、打开终端，执行 Homebrew 安装命令（如已安装可跳过）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2、添加 Dart 官方仓库源：
brew tap dart-lang/dart
3、安装 Dart SDK：
brew install dart
4、验证安装结果：
dart --version
二、手动下载并配置 SDK 路径
当 Homebrew 因网络问题无法拉取资源时，可直接从官方镜像下载预编译的 Dart SDK 归档包，并手动配置环境变量。该方式不依赖包管理器，适合受限网络环境。
1、创建开发目录并进入：
mkdir -p ~/development
cd ~/development
2、使用 curl 下载 Dart SDK（以稳定版为例，URL 可替换为最新清华镜像链接）：
curl -O https://mirrors.tuna.tsinghua.edu.cn/dart-archive/channels/stable/release/latest/sdk/dartsdk-macos-x64-release.zip
3、解压并重命名：
unzip dartsdk-macos-x64-release.zip
mv dart-sdk dart
4、编辑 shell 配置文件（macOS Catalina 及更新版本默认使用 zsh）：
nano ~/.zshrc
5、在文件末尾添加以下行（请将路径替换为实际解压位置）：
export PATH="$PATH:$HOME/development/dart/bin"
6、保存后重新加载配置：
source ~/.zshrc
7、验证是否生效：
dart --version
三、通过 Flutter SDK 间接使用 Dart
Flutter SDK 自带完整 Dart 运行时与工具链，若您已安装或计划使用 Flutter，则无需单独安装 Dart SDK。所有 dart 命令均可由 Flutter 提供的二进制文件代理执行，前提是 PATH 已包含 Flutter 的 bin 目录。
1、确认 Flutter 已安装并配置到 PATH：
flutter --version
2、检查 Flutter 内置 Dart 版本：
flutter dart --version
3、直接运行 Dart 文件（无需额外 dart 命令）：
flutter dart run /path/to/your/app.dart
4、如需全局调用 dart 命令，可创建软链接（需确保 flutter/bin 在 PATH 中）：
ln -s $(which flutter) /usr/local/bin/dart
四、验证与基础测试
无论采用哪种安装方式，都必须验证 Dart 是否能正确解析语法并执行代码。此步骤可暴露环境变量遗漏、权限异常或架构兼容性问题。
1、新建一个测试文件：
echo "void main() { print('Hello from Dart!'); }" > hello.dart
2、在终端中执行该文件：
dart hello.dart
3、观察输出是否为：
Hello from Dart!
4、若报错 command not found: dart，请返回检查 ~/.zshrc 中 PATH 设置及 source 执行情况。
