Flutter 环境变量配置问题

71 阅读1分钟

1️⃣ 检查 .zshrc 是否配置正确

打开 .zshrc 文件

nano ~/.zshrc

在文件末尾添加以下内容

# Flutter 路径
export PATH="$PATH:$HOME/flutter/bin"

# Dart 路径(如果有 dart pub global activate 命令)
export PATH="$PATH:$HOME/.pub-cache/bin"

# M1 Mac Homebrew 路径
export PATH=$PATH:/opt/homebrew/bin:/opt/homebrew/sbin

2️⃣ 重新加载 .zshrc 文件

重新加载 .zshrc 文件

source ~/.zshrc

这会使环境变量立即生效,而不需要重启终端。

3️⃣ 确认路径是否加载成功

验证环境变量 $PATH 是否包含正确路径

echo $PATH

期望输出

/Users/your-username/flutter/bin:/Users/your-username/.pub-cache/bin:/opt/homebrew/bin:...

如果路径仍然没有正确加载,请继续以下步骤。

4️⃣ 确认 .zshrc 文件是否生效 有时 .zshrc 文件可能未被 zsh 读取。你可以使用以下命令强制 zsh 使用 .zshrc

echo $SHELL

如果输出如下:

/bin/zsh

这表示 zsh 是默认 Shell,应该会加载 ~/.zshrc 文件。

如果不是 /bin/zsh,则需要将默认 Shell 改为 zsh

chsh -s /bin/zsh

5️⃣ 检查 .zprofile 是否加载 .zshrc 在某些情况下,尤其是 M1 Mac, .zprofile 文件会影响 .zshrc 的加载。

你可以确保 .zprofile 加载了 .zshrc,方法如下: 打开 .zprofile 文件

nano ~/.zprofile

在文件末尾添加以下内容

# 加载 .zshrc
if [ -f ~/.zshrc ]; then
  source ~/.zshrc
fi

保存并退出(按 Ctrl + O,然后按 Enter,最后按 Ctrl + X 退出编辑器)。 重新加载 .zprofile

source ~/.zprofile

6️⃣ 终极方案:重启电脑

如果上面的方法都不起作用,重启电脑

M1 Mac 有时会缓存 Shell 环境,重启可以确保 zsh 加载新的 .zshrc 和 .zprofile 文件。