安裝說明

本頁面描述了 Flutter 新手用戶常遇到的一些安裝問題，並提供解決方案建議。如果您仍然遇到問題，請考慮透過社群支援管道中列出的資源尋求協助。若要在此頁面新增主題或進行更正，您可以使用頁面頂端的按鈕提交問題或發送 Pull Request。

這個問題看起來像什麼？

當您嘗試執行 flutter 命令時，主控台找不到該命令。錯誤訊息通常如下所示

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

在 macOS 和 Linux 上的錯誤訊息可能與 Windows 上的略有不同。

說明與建議

您是否已將 Flutter 加入您平台的 PATH 環境變數中？在 Windows 上，請按照這些將命令加入路徑的說明進行操作。

如果您已設定 VS Code 進行 Flutter 開發，您可以使用 Flutter 擴充功能的「尋找 SDK」提示來識別您的 flutter 資料夾位置。

另請參閱：設定 PATH 和環境變數 - Dart Code

這個問題看起來像什麼？

執行您的 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。

這個問題看起來像什麼？

命令 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 Development Kit (JDK) 時，會發生此錯誤。

如果您不需要多個版本的 Java，請從您的電腦解除安裝現有的 JDK。Flutter 會自動使用 Android Studio 中包含的 JDK。

如果您確實需要其他版本的 Java，請嘗試這個 GitHub 問題中描述的變通方法，直到實施長期解決方案為止。如需更多資訊，請查看Android Java Gradle 遷移指南或flutter doctor --android-licenses not working due to java.lang.UnsupportedClassVersionError - Stack Overflow。

這個問題看起來像什麼？

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. 從 Android Studio 開啟 SDK 管理器，從選單列中選擇「工具 > SDK 管理器」。
2. 選取最新的 Android SDK (或您的應用程式所需的特定版本)、Android SDK Command-line Tools 和 Android SDK Build-Tools。
3. 點擊「套用」以安裝選取的元件。

如果您未使用 Android Studio，則可以使用 sdkmanager 命令列工具下載這些工具。

這個問題看起來像什麼？

執行 flutter 命令會產生「exit code: 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 社群樂於助人且歡迎新成員。如果上述建議都無法解決您的安裝問題，請考慮從以下管道之一尋求支援

• /r/flutterhelp on Reddit
• /r/flutterdev on Discord，特別是此伺服器上的 install-and-setup 頻道。
• StackOverflow，尤其是標記為 #flutter 或 #dart 的問題。

為了尊重大家的時間，請在發布新問題之前搜尋是否有類似的問題。

除非另有說明，本網站上的文件反映了 Flutter 的最新穩定版本。本頁面最後更新於 2024-04-04。 檢視原始碼 或 回報問題。