Skip to main content
Contents

安装帮助

Contents

本页面描述了一些 Flutter 新用户遇到的常见安装问题，并提供了解决方法建议。如果您仍然遇到问题，请考虑联系“社区支持渠道”中列出的任何资源。要向此页面添加主题或进行更正，您可以使用页面顶部的按钮提交问题或拉取请求。

获取 Flutter SDK

#

找不到 flutter 命令

#

此问题是什么样的？

当您尝试运行 flutter 命令时，控制台找不到它。错误通常如下所示：

'flutter' 不是内部或外部命令、可运行的程序或批处理文件

macOS 和 Linux 上的错误消息可能与 Windows 上的略有不同。

解释和建议

您是否已为您的平台将 Flutter 添加到 PATH 环境变量？在 Windows 上，请按照这些将命令添加到您的路径的说明操作。

如果您已经为 Flutter 开发设置了 VS Code，您可以使用 Flutter 扩展的查找 SDK 提示来识别 flutter 文件夹的位置。

另请参阅：配置 PATH 和环境变量 - Dart 代码

Flutter 在特殊文件夹中

#

此问题是什么样的？

运行您的 Flutter 项目会产生如下错误：

Flutter SDK 安装在受保护的文件夹中，可能无法正常工作。
请将 SDK 移动到无需管理员权限即可用户写入的位置，然后重新启动。

解释和建议

在 Windows 上，这通常发生在 Flutter 安装在需要提升权限的目录（如 C:\Program Files\）中时。尝试将 Flutter 重新定位到不同的文件夹，例如 C:\src\flutter。

Android 设置

#

安装了多个版本的 Java

#

此问题是什么样的？

flutter doctor --android-licenses 命令失败。运行 flutter doctor –verbose 会给出如下错误消息：

java.lang.UnsupportedClassVersionError: com/android/prefs/AndroidLocationsProvider 已由较新版本的 Java 运行时 (类文件版本 55.0) 编译，此版本的 Java 运行时仅识别最多 52.0 的类文件版本

解释和建议

当您的计算机上安装了较旧版本的 Java 开发工具包 (JDK) 时，就会发生此错误。

如果您不需要多个版本的 Java，请从您的计算机上卸载现有的 JDK。Flutter 会自动使用 Android Studio 中包含的 JDK。

如果您确实需要另一个版本的 Java，请尝试此 GitHub 问题中描述的解决方法，直到实施长期解决方案为止。有关更多信息，请查看Android Java Gradle 迁移指南或由于 java.lang.UnsupportedClassVersionError 而导致 flutter doctor --android-licenses 不起作用 - Stack Overflow。

缺少 cmdline-tools 组件

#

此问题是什么样的？

flutter doctor 命令抱怨 Android 工具链中缺少 cmdline-tools。例如：

[!] Android 工具链 - 为 Android 设备开发 (Android SDK 版本 33.0.2)
    • Android SDK at C:\Users\My PC\AppData\Local\Android\sdk
    X 缺少 cmdline-tools 组件

解释和建议

获取 cmdline-tools 最简单的方法是通过 Android Studio 中的 SDK Manager。为此，请使用以下说明：

  1. 从 Android Studio 中打开 SDK Manager，方法是从菜单栏中选择工具 > SDK Manager。
  2. 选择最新的 Android SDK（或您的应用所需的特定版本）、Android SDK 命令行工具和 Android SDK Build-Tools。
  3. 单击 应用 以安装选定的工件。

Android Studio SDK Manager

如果您不使用 Android Studio，您可以使用sdkmanager 命令行工具下载这些工具。

其他问题

#

退出代码 69

#

此问题是什么样的？

运行 flutter 命令会产生“退出代码：69”错误，如下例所示：

在 flutter_tools 中运行“flutter pub get”…
在 .../flutter/packages/flutter_tools 中解析依赖项… (28.0s)
尝试在 https://pub.dev/ 处查找包测试时出现 TLS 错误。
pub get 失败
命令：
".../flutter/bin/cache/dart-sdk/bin/
dart __deprecated_pub --color --directory
.../flutter/packages/flutter_tools get --example"
pub 环境：{
  "FLUTTER_ROOT": ".../flutter",
  "PUB_ENVIRONMENT": "flutter_cli:get",
  "PUB_CACHE": ".../.pub-cache",
}
退出代码：69

解释和建议

此问题与网络有关。请尝试以下说明进行故障排除：

  • 检查您的互联网连接。确保您已连接到互联网并且您的连接稳定。
  • 重新启动您的设备，包括您的计算机和网络设备。
  • 使用 VPN 来帮助绕过可能阻止您连接到网络的任何限制。
  • 如果您已尝试所有这些步骤但仍然收到错误，请使用 flutter doctor -v 命令打印详细日志，并在“社区支持渠道”之一中寻求帮助。

社区支持

#

Flutter 社区乐于助人且热情好客。如果以上建议都不能解决您的安装问题，请考虑从以下渠道之一寻求支持：

为了尊重每个人的时间，请在发布新问题之前搜索存档中是否存在类似的问题。

除非另有说明，否则本网站上的文档反映的是 Flutter 的最新稳定版本。页面最后更新于 2025-01-30。 查看源代码 或 报告问题。