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

Flutter用Flutter Launcher Icons改图标报InvalidConfigException如何修复

Flutter Launcher Icons 出现 InvalidConfigException 报错修复方法

这个报错是配置不符合工具校验规则导致的,按以下顺序排查即可解决:

  • 首先检查YAML文件缩进格式
    YAML语法对缩进要求非常严格,flutter_launcher_icons配置块必须和dev_dependencies、flutter配置块处于同一缩进层级,不能嵌套在其他配置块内部,所有子配置统一用2个空格缩进,绝对不能用Tab键缩进。
    正确配置参考:
    dev_dependencies:
      flutter_launcher_icons: ^0.13.1 # 替换为你使用的对应版本
    
    # 注意这一行前面没有多余空格,和上面的dev_dependencies同级
    flutter_launcher_icons:
      android: "launcher_icon"
      ios: true
      image_path: "assets/icons/app_icon.png" # 替换为你的图标实际路径
      min_sdk_android: 21
    
    最高发的缩进错误是把flutter_launcher_icons写到flutter:块的子级,或者子配置缩进多了/少了2个空格,直接触发配置无效异常。
  • 核对图标文件路径
    配置里image_path填写的路径必须和项目内图标实际存放路径完全一致:
    • 图标要放在Flutter项目根目录的对应文件夹下,不要放到android、ios子目录内
    • 路径不要以/开头,开头加斜杠会被工具识别为系统绝对路径,直接找不到文件
    • 文件名、后缀名要完全匹配,注意区分大小写,不要把.png写成.jpg,也不要漏写文件名里的字符
  • 检查配置字段拼写和值格式
    不要拼错配置字段,比如不要把image_path写成imagepath、漏写下划线;布尔类型的配置值比如ios: true不要加引号,字符串类型的值注意补全引号。
  • 排查完成后按顺序执行以下命令重新生成:
    1. 执行flutter clean清理项目缓存
    2. 执行flutter pub get重新拉取依赖
    3. 执行flutter pub run flutter_launcher_icons生成图标

如果以上步骤做完还是报错,直接把pubspec.yaml里现有的flutter_launcher_icons相关配置全部删除,手动按照参考配置重新输入,不要复制粘贴带富文本格式的内容,避免隐藏格式字符导致配置解析失败。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.28 00:27:25