在Codemagic中运行Dart命令提示dart: Command not found错误如何解决

1. 检查构建环境镜像配置 #

• 进入对应工作流的Environment配置页，确认Flutter version字段选择了具体版本而非None。Codemagic提供的所有带Flutter的镜像均内置对应版本Dart SDK，无需额外安装即可直接调用。
• 若项目为纯Dart项目无需依赖Flutter，可在工作流的Dependency install阶段执行以下命令主动安装Dart SDK：

sudo apt update && sudo apt install apt-transport-https wget -y
wget -qO- https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo gpg --dearmor -o /usr/share/keyrings/dart.gpg
echo 'deb [signed-by=/usr/share/keyrings/dart.gpg arch=amd64,arm64] https://storage.googleapis.com/download.dartlang.org/linux/debian stable main' | sudo tee /etc/apt/sources.list.d/dart.list
sudo apt update && sudo apt install dart -y

2. 手动添加Dart路径到环境变量 #

如果已确认安装了Dart SDK还是提示命令不存在，是因为Dart路径未被加入当前会话的系统PATH：

• 使用Codemagic内置Flutter环境的场景，执行命令添加路径：

export PATH="$FLUTTER_ROOT/bin/cache/dart-sdk/bin:$PATH"

• 手动安装Dart的场景，执行命令添加路径：

export PATH="/usr/lib/dart/bin:$PATH"

• 路径添加完成后执行dart --version验证，正常输出版本号即代表问题解决。

3. 调整命令执行阶段 #

所有需要调用Dart的命令，需放置在工作流的Dependency install阶段之后执行，避免在环境未初始化完成的前置步骤中调用命令导致找不到。

内容的提问来源于stack exchange，提问作者Mikhail Tokarev