使用MacPro 安装flutter开发环境 详细教程

Mac 有 英特尔芯片 和 苹果芯片，故安装路径可能略有不同，但是思路 大致一样，以下内容仅供小伙伴们参考：
首先下载环境安装的软件，并推荐使用稳定版本。

gralde 8.5 点击下载

android studio 点击下载

jdk 点击下载

fluter Sdk 点击下载

使用shell 命令配置 ：
注意 ： 使用 shell 命令 两个脚本文件配置 环境 是的使用大致说明如下：

1. ‌适用 Shell 类型‌
   ‌.bash_profile‌
   专用于 ‌Bash Shell‌（macOS Catalina （10.15.7） 之前版本的默认 Shell）1
   ‌.zshrc‌
   专用于 ‌Zsh Shell‌（macOS Catalina （10.15.7） 及之后版本的默认 Shell）
   自己看下苹果系统版本：选择
   命令如下：

open ~/.bash_profile 
open ~/.zshrc

大致要配置内容如下：

session *as a function*
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home
export PATH=$JAVA_HOME/bin:$PATH:.
export CLASSPATH=$JAVA_HOME/lib/tools.jar:$JAVA_HOME/lib/dt.jar:.
export ANDROID_HOME=/Users/jwzh/Library/Android/sdk
export PATH=${PATH}:${ANDROID_HOME}/tools
export PATH=${PATH}:${ANDROID_HOME}/platform-tools
export GRADLE_HOME=/Users/jwzh/Library/Android/gradleVersion/gradle-8.5
export PATH=${PATH}:${GRADLE_HOME}/bin
export FLUTTER_HOME=/Users/jwzh/Flutter/flutter
export PATH=${PATH}:${FLUTTER_HOME}/bin
export DART_HOME=/Users/jwzh/Flutter/flutter/bin/cache/dart-sdk
export PATH=${PATH}:${DART_HOME}/bin
export RUBY_HOME=/usr/local/opt/ruby/3.4.4/bin
export PATH=${PATH}:${RUBY_HOME}
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
export PATH="$PATH":"$HOME/.pub-cache/bin"
export PATH="$HOME/.rbenv/shims:$PATH"
export POD_HOME=/Users/jwzh/.rbenv/versions/3.4.4/bin
export PATH=${PATH}:${POD_HOME}

保存文件 刷新环境变了配置

srouce  ~/.bash_profile 
srouce  ~/.zshrc

遇到安装cocoapods。失败的小伙伴 需要 检查自己电脑是否安装了 ruby 语言环境 以及 cocoapods版本。

ruby -v
pod -v

mac 电脑自带了 ruby 版本，但是有时候我们需要切换成自己安装的版本
需要使用 rbn管理 版本 查看安装如下：

1、安装 rbenv 和 ruby-build
brew install rbenv ruby-buildbash
2、初始化 rbenv（写入 zsh 配置）
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc
source ~/.zshrcbash
3、配置 ruby-build 使用国内镜像（清华源）
export RUBY_BUILD_MIRROR_URL=https://cache.ruby-china.com/pub/rubybash
4、查看最新版 Ruby
rbenv install -l | grep -v - | tailbash可能会看到以下几个版本输出3.1.4
3.2.3
3.3.0bash安装最新稳定版（比如 3.3.0）rbenv install 3.3.0
rbenv global 3.3.0
AI写代码
bashruby -v解决 ： 在 Mac 上无法使用 rbenv 更改 Ruby 版本export PATH="$HOME/.rbenv/shims:$PATH"

遇到ruby 版本和 cocoapods 版本不配对 ，需要先清除cocoapods 版本

sudo gem update cocoapods要彻底清理 ~/.cocoapods 目录及相关缓存文件，请按以下步骤操作：1. 删除核心目录
执行以下命令移除 CocoaPods 本地仓库和配置：bash
Copy Code
rm -rf ~/.cocoapods
此操作会删除所有已下载的 Podspec 仓库（如 trunk 或 master）23。2. 清理缓存文件
同时删除缓存目录以释放空间：bash
Copy Code
rm -rf ~/Library/Caches/Cocoapods
该目录存储了已下载的第三方库缓存，清理后可节省约 1GB 空间14。3. 补充清理（可选）
‌DerivedData‌：清除 Xcode 构建缓存（可能包含 Pods 相关中间文件）：bash
Copy Code
rm -rf ~/Library/Developer/Xcode/DerivedData/*
12。‌工程文件‌：若需从项目中移除 CocoaPods，还需删除 Podfile、Podfile.lock、Pods 文件夹及 .xcworkspace 文件57。4. 验证清理结果
运行以下命令确认无残留：bash
Copy Code
pod --version  # 应提示命令未找到
ls ~/.cocoapods  # 目录不应存在

解决 代理和 安装源问题：

其中 github 的问题，最好通过设置一个代理解决，github设置代理方式如下：git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890切换 Google 源
marven的部分最好替换一个国内的源，替换步骤如下：
我用的是: https://dl.google.com/dl/android/maven2打开flutter根目录
打开文件 packages/flutter_tools/lib/src/http_host_validator.dart
修改其中 kMaven（修改地址如下：http://maven.aliyun.com/nexus/content/groups/public/）重新执行 flutter doctor还有关键的一步，需要删除掉flutter运行工具的缓存文件。
cd ${flutter_sdk}/bin/cache/flutter_tools.snapshot

再次检测 ：

jwzh@jwzhs-MacBook-Pro ~ % flutter doctor
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.24.0, on macOS 15.4.1 24E263 darwin-x64, locale zh-Hans-CN)
[✓] Android toolchain - develop for Android devices (Android SDK version 35.0.1)
[!] Xcode - develop for iOS and macOS (Xcode 16.3)✗ CocoaPods installed but not working.You appear to have CocoaPods installed but it is not working.This can happen if the version of Ruby that CocoaPods was installed with is different from the one beingused to invoke it.This can usually be fixed by re-installing CocoaPods.For re-installation instructions, see https://guides.cocoapods.org/using/getting-started.html#installation
[✓] Chrome - develop for the web
[✓] Android Studio (version 2024.2)
[✓] Connected device (3 available)
[✓] Network resourcesjwzh@jwzhs-MacBook-Pro ~ % ruby -v
ruby 3.4.4 (2025-05-14 revision a38531fd3f) +PRISM [x86_64-darwin24]
安装 cocopods. 之前我们清除了 cocoapos 重启 mac后再次安装。