乐于分享
好东西不私藏

Flutter的安装教程

Flutter的安装教程
    最近想研究Flutter的心越发强烈.今天就着手开始搭建了环境. 现在我把我的安装教程提供给大家,可能有不足请指教.
    好了,我们废话少说那么久开始吧.
    首先我的开发环境是MacOS,那么我就按照我的搭建步骤来给大家讲解一下.我是使用brew的方式来安装的,如果没有brew环境请自行搜索哈.

一、基础安装(核心步骤)

  1. 1. 安装 Flutter(brew 方式,适配你的环境)

brew install flutter
  • ✅ 验证:flutter --version能输出 Flutter 版本(如 3.41.4)即为安装成功。

2. 配置 Flutter 环境变量(解决命令识别问题)

# 1. 打开 zsh 配置文件open -e ~/.zshrc# 2. 在文件末尾添加(优先加载 Flutter 路径):export PATH="/opt/homebrew/share/flutter/bin:$PATH"# 3. 国内用户补充镜像(解决依赖下载慢):export PUB_HOSTED_URL=https://pub.flutter-io.cnexport FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn# 4. 使配置生效source ~/.zshrc
⚠️Flutter下载好了以后他本身是已经包含了Dart语言的所以不需要单独下载了.如果你之前单独下载过也不用怕他会自然提示你路径冲突

二、解决 Dart 冲突(关键修复)

  1. 1. 卸载单独安装的 Dart(避免和 Flutter 内置 Dart 冲突)
brew uninstall dartbrew cleanup dart
    2. 验证 Dart 路径(确保使用 Flutter 内置版本)
    which dart
    ✅ 正确输出:/opt/homebrew/share/flutter/bin/dart
    ❌ 若提示 dart not found
    那么就执行以下指令重新配置
    sed -i '' '/flutter\/bin/d' ~/.zshrcopen -e ~/.zshrcecho 'export PATH="/opt/homebrew/share/flutter/bin:$PATH"' >> ~/.zshrcsource ~/.zshrc

    三、环境检查与优化(可选)

    1. 1. 执行 flutter doctor 检查环境

      flutter doctor
    • 仅需关注「Dart 路径冲突」提示是否消失,其余(如 Android 工具链)仅在开发安卓应用时处理;
    • 若提示 Android 许可证问题:flutter doctor --android-licenses(按提示输入 y接受)。
      我这里就出现了点问题.Android 工具链问题(仅开发安卓需修复,否则可忽略)
      问题点
      影响
      解决方案
      cmdline-tools 缺失
      无法编译安卓应用
      方法 1(推荐):1. 打开 Android Studio → 偏好设置 → Android SDK → SDK Tools2. 勾选「Android SDK Command-line Tools (latest)」→ 安装方法 2(无 AS):1. 下载:
      https://developer.android.com/studio#command-line-tools-only2. 解压到 ~/Library/Android/sdk/cmdline-tools/latest3. 配置环境变量:export ANDROID_HOME="$HOME/Library/Android/sdk"export PATH="$PATH:$ANDROID_HOME/cmdline-tools/latest/bin"
      Android 许可证未接受
      无法打包安卓应用
      执行命令:flutter doctor --android-licenses→ 全程输入 y接受所有许可证
    2. 修复代理提示(可选)
    # 打开 ~/.zshrc 添加:export NO_PROXY="localhost,127.0.0.1,::1,*.flutter-io.cn,*.google.cn"# 生效配置:source ~/.zshrc

    核心关键点回顾

    1. 核心逻辑
      :Flutter 内置 Dart,无需单独安装 Dart,卸载单独 Dart 可彻底解决版本冲突;
    2. 环境变量优先级
      :必须将 Flutter 的 bin目录放在 PATH 最前面,确保系统优先识别内置 Dart;
    3. 验证标准
      • flutter --version
        正常输出版本;
      • dart --version
        输出 Flutter 内置的 Dart 版本(如 3.41.4);
      • flutter doctor
        无 Dart 路径冲突提示。

    至此,你的 Flutter 环境已完全可用,可正常进行 Flutter 项目开发(iOS / 网页 / 安卓,安卓需额外配置 cmdline-tools)。