在 .NET MAUI 中修改应用图标和启动页只需在 .csproj 文件中配置 和 ,仅识别第一个匹配项,支持 SVG/PNG,需遵守命名规范并执行 Clean + Rebuild。

在 .NET MAUI 中修改应用图标(AppIcon)和启动页(Splash Screen),核心操作都在项目文件(.csproj)里完成,不需要为每个平台单独准备多套图片——MAUI 会自动缩放适配。关键点是:只认第一个 ,SVG 推荐但 PNG 也完全可用,命名要合规,启动页用 单独配置。
修改应用图标(AppIcon)
MAUI 应用图标由项目文件中的 项控制,系统只处理第一个定义,其余会被忽略。你只需替换文件并更新路径即可:
- 把新图标(推荐 PNG,也可用 SVG)放进
Resources\AppIcon\文件夹,文件名必须全小写、只含字母/数字/下划线,比如myappicon.png - 右键项目 → “编辑项目文件”,找到或添加
节点,填入路径: - 如需前景+背景分层(例如浅色图标配深色底),可加
ForegroundFile和Color: - 若想按平台差异化设置(比如 Windows 用另一张图),可用条件判断,但注意仍只取第一个匹配项:
修改启动页(Splash Screen)
启动页是 App 启动瞬间显示的静态画面,由 控制,同样支持 SVG 或 PNG,MAUI 会自动生成各平台所需尺寸:
- 把启动图放进
Resources\Splash\,比如splash.png - 在 .csproj 中添加或修改节点:
-
BaseSize是原始画布尺寸(单位 px),用于缩放计算;Color是背景色,当图片透明时可见 - 不支持动画或 HTML 内容,纯静态图像;如需更定制化加载界面(比如带文字或进度条),得在 Blazor 或 Shell 初始化阶段手动实现
顺便改掉应用名称(Display Name)
应用在手机桌面显示的名字,不是项目名,而是用户看到的“App 名称”,修改位置有两个:
- 主项目文件中设置
,影响所有平台:我的阅读器 - Android 平台还可额外在
Platforms\Android\AndroidManifest.xml中确认android:label是否同步(一般会自动继承,除非手动覆盖) - iOS 和 Windows 需分别检查
Platforms\iOS\Info.plist和Platforms\Windows\Package.appxmanifest中对应字段
常见问题提醒
这些细节容易踩坑,改完记得 Clean + Rebuild:
- 图标文件名不合法(含大写字母、短横线、中文)会导致构建失败或图标不显示
- 没删旧的
行,新加的可能被跳过——务必确保只有一个生效项 - SVG 图标若含外部引用、JS 或复杂滤镜,MAUI 转换时可能出错,建议用简化版 SVG 或直接上 PNG
- 真机调试时图标未更新?先卸载旧 App,再部署,避免系统缓存旧图标资源
基本上就这些。改图标和启动页不复杂,但容易忽略命名规则和“只取第一个”的限制。










