You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

flutter doctor提示cmdline-tools component is missing如何解决

Flutter 运行flutter doctor提示「cmdline-tools component is missing」修复方案

按以下顺序排查操作即可解决绝大多数同类问题:

  • 校验cmdline-tools目录结构
    打开Android Studio SDK配置页显示的SDK根目录(即Android SDK Location对应的路径),检查cmdline-tools目录层级是否符合标准:
    SDK根目录/
    ├─ build-tools/
    ├─ cmdline-tools/
    │  └─ latest/
    │     ├─ bin/
    │     ├─ lib/
    │     └─ 其余cmdline-tools相关文件
    ├─ platforms/
    └─ platform-tools/
    
    手动解压安装cmdline-tools时很容易遗漏latest这一层目录,直接把bin、lib等文件放在cmdline-tools根目录下,这种情况Flutter无法识别组件,调整目录到对应层级即可。
  • 校验环境变量配置
    1. 确认系统变量中同时配置了ANDROID_HOME和ANDROID_SDK_ROOT,两个变量值均填写Android SDK根目录的绝对路径,不要填写Android Studio安装路径,也不要填写cmdline-tools的子路径。
    2. 打开系统变量的Path项,确认存在以下三个条目:
      • %ANDROID_HOME%\cmdline-tools\latest\bin
      • %ANDROID_HOME%\platform-tools
      • %ANDROID_HOME%\emulator
    3. 配置完成后必须关闭所有已打开的终端、CMD、PowerShell窗口,重新打开终端才会加载更新后的环境变量。
  • 命令行补装组件+接受许可证
    在新开的终端中依次执行以下命令:
    1. 执行sdkmanager --install "cmdline-tools;latest",命令会自动在正确路径下安装最新版cmdline-tools,避免Android Studio界面手动安装出现的路径不匹配问题。
    2. 执行flutter doctor --android-licenses,所有交互提示均输入y后回车,直到终端提示所有Android许可证已接受完成。
  • 结果校验
    上述操作完成后,在终端执行flutter doctor,cmdline-tools相关报错会直接消失。

注意:如果仅在Android Studio的SDK Tools界面勾选了特定旧版本的cmdline-tools、未勾选latest版本,同样会触发该报错,直接执行上述sdkmanager安装命令即可自动补全对应组件,无需在界面反复勾选调试。

内容的提问来源于stack exchange,提问作者Miran

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.27 05:57:25