图标显示异常时，首选重启ukui-panel服务；若无效，依次清除~/.cache和~/.config中ukui缓存、切换图标主题、重装ukui-icon-theme包、重建hicolor与ukui图标缓存。

如果您在银河麒麟系统中发现软件图标显示为白色方块、模糊、错位或完全不显示，则很可能是图标缓存文件损坏或未正确加载所致。以下是针对该问题的多种重置方法：

一、重启UKUI桌面面板服务

ukui-panel 是负责渲染桌面图标、任务栏及托盘区域的核心进程；其异常运行会导致图标资源加载失败，重启该服务可强制刷新图标渲染链路。

1、按下 Ctrl + Alt + T 打开终端。

2、输入命令：pkill ukui-panel 并回车，终止当前面板进程。

3、等待约3秒，系统将自动拉起新面板；若未恢复，手动执行：ukui-panel &。

4、观察桌面图标是否恢复正常显示。

二、清除用户级图标缓存目录

麒麟系统将图标缩略图与布局状态缓存在用户主目录下的 .cache 和 .config 子目录中；缓存损坏会直接导致图标渲染异常，需手动清理并触发重建。

1、打开终端，执行：rm -rf ~/.cache/ukui-panel ~/.cache/icon-cache。

2、继续执行：rm -rf ~/.config/ukui/panel*，清除面板配置缓存。

3、输入命令：pkill ukui-panel 确保旧进程已退出。

4、系统将自动启动新面板，图标缓存将在首次绘制时重建。

三、更换桌面主题强制刷新图标资源

切换主题会触发UKUI框架重新加载所有图标资源包（包括hicolor、ukui-icon-theme等），从而绕过损坏的缓存路径，实现软性重置。

1、右键桌面空白处，选择“个性化”或“外观设置”。

2、在“主题”或“图标主题”选项中，从下拉列表中选择一个不同于当前使用的图标主题（例如由“UKUI Default”切换为“HighContrast”）。

3、确认应用后，等待5秒，再切回原主题（如需保留原风格）。

4、观察所有软件图标是否恢复清晰显示。

四、重装核心图标主题组件

当系统图标主题包（ukui-icon-theme）文件缺失、版本不匹配或权限异常时，仅刷新缓存无效，必须通过包管理器校验并重装。

1、打开终端，执行：sudo apt update 更新软件源索引。

2、执行重装命令：sudo apt install --reinstall ukui-icon-theme。

3、安装完成后，运行：sudo chmod -R 644 /usr/share/icons/ukui* 修复可能的权限错误。

4、执行：pkill ukui-panel，等待面板自动重启。

五、手动重建全局图标数据库（适用于深度异常）

部分第三方或自编译应用图标依赖于系统的 icon-theme.cache 文件；该文件损坏将导致新安装程序图标无法识别，需调用 gtk-update-icon-cache 工具重建。

1、打开终端，执行：sudo gtk-update-icon-cache -f -t /usr/share/icons/hicolor。

2、继续执行：sudo gtk-update-icon-cache -f -t /usr/share/icons/ukui。

3、若提示“Permission denied”，先运行：sudo chown root:root /usr/share/icons/*/icon-theme.cache。

4、完成后再重启 ukui-panel 进程。