内容
description bug_report

安装帮助

内容

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

获取 Flutter SDK

找不到 flutter 命令

此问题是什么样的？

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

'flutter' is not recognized as an internal or external command operable program or batch file

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

说明和建议

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

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

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

Flutter 在特殊文件夹中

此问题是什么样的？

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

The Flutter SDK is installed in a protected folder and may not function correctly.
Please move the SDK to a location that is user-writable without Administration permissions and restart.

说明和建议

在 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 
has been compiled by a more recent version of the Java Runtime (class file version 55.0), 
this version of the Java Runtime only recognizes class file versions up to 52.0

说明和建议

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

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

如果您确实需要其他版本的 Java，请尝试在实施长期解决方案之前，在 此 GitHub 问题 中描述的解决方法。如需了解更多信息，请查看 Android Java Gradle 迁移指南 或 flutter doctor –android-licenses 因 java.lang.UnsupportedClassVersionError 而无法运行 - Stack Overflow。

缺少 cmdline-tools 组件

此问题是什么样的？

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

[!] Android toolchain - develop for Android devices (Android SDK version 33.0.2) 
    • Android SDK at C:\Users\My PC\AppData\Local\Android\sdk 
    X cmdline-tools component is missing

说明和建议

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

  1. 通过从菜单栏中选择工具 > SDK 管理器，从 Android Studio 打开 SDK 管理器。
  2. 选择最新的 Android SDK（或应用程序所需的特定的版本）、Android SDK 命令行工具和 Android SDK 构建工具。
  3. 单击应用以安装所选的工件。

Android Studio SDK Manager

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

其他问题

退出代码 69

此问题是什么样的？

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

Running "flutter pub get" in flutter_tools...
Resolving dependencies in .../flutter/packages/flutter_tools... (28.0s)
Got TLS error trying to find package test at https://pub.dev/.
pub get failed
command:
".../flutter/bin/cache/dart-sdk/bin/
dart __deprecated_pub --color --directory
.../flutter/packages/flutter_tools get --example"
pub env: {
  "FLUTTER_ROOT": ".../flutter",
  "PUB_ENVIRONMENT": "flutter_cli:get",
  "PUB_CACHE": ".../.pub-cache",
}
exit code: 69

说明和建议

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

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

社区支持

Flutter 社区乐于助人且欢迎所有人。如果上述建议均无法解决你的安装问题，不妨考虑通过以下渠道寻求支持

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