应直接安装腾讯与统信联合适配的原生qq uos版，通过应用商店搜索“qq uos版”（版本≥3.2.28-1152），安装后清除~/.config/tencent/qq/下customface.db等缓存文件以修复表情显示异常。
在统信UOS系统中安装QQ Linux版，需避开Wine兼容层、第三方未签名包及架构错配的.deb文件，直接选用腾讯与统信联合适配的原生Linux版本，否则将出现扫码后闪退、表情不显示、联系人不同步等基础功能异常。
通过应用商店安装原生QQ UOS版
这是最稳妥的方式，无需判断CPU型号、不涉及终端命令、无依赖冲突风险，适用于所有统信UOS V20 1050及以上版本用户。
点击屏幕左下角“开始菜单”，打开“应用商店”。
在顶部搜索框中输入“QQ”，按回车键检索；必须确认结果中显示的应用名称为【QQ UOS版】，右下角有“Linux”标签，且版本号为3.2.28-1152或更高（截至2026年8月最新上架版本）。
若搜索结果为空或版本过低，立即关闭应用商店，打开终端执行：sudo apt clean && sudo apt update，然后重启应用商店重试。
点击“安装”按钮，输入管理员密码授权，等待进度条完成；安装完毕后，在启动器中单击QQ图标启动。
扫码登录后暂不聊天，进入下一步排查缓存问题——这一步跳过会导致后续表情无法显示。
清除表情数据库与本地缓存
90%以上的表情不显示问题，源于CustomFace.db文件损坏。该文件存储本地表情索引，一旦损坏，客户端会拒绝加载全部表情资源，包括默认黄脸和自定义GIF包。
方法一：图形化路径清理（推荐）
右键任务栏QQ图标→选择“退出”，确保进程完全消失；若图标仍存在，再执行一次。
按下Ctrl+H显示隐藏文件夹，进入~/.config/Tencent/QQ/（注意不是/opt/下的安装目录）。
找到并删除以下两个文件：CustomFace.db与CustomFac.dbc；若该目录下不存在，检查路径是否为~/.config/Tencent/QQ/Users/[你的QQ号]/。
重新启动QQ，首次登录时自动重建数据库，5秒内即可正常发送和接收表情。
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
方法二：终端命令一步清理（适合批量处理或脚本化）
确保QQ已完全退出，打开终端执行：rm -f ~/.config/Tencent/QQ/CustomFace.db ~/.config/Tencent/QQ/CustomFac.dbc。
如提示“no match”，说明路径偏移，改用：find ~/.config/Tencent/QQ -name "CustomFace.db" -delete 2>/dev/null。
手动安装匹配架构的签名.deb包
仅当应用商店未显示QQ UOS版、或需部署于龙芯3A6000、兆芯KX-6000等特殊平台时启用。混用架构将导致安装失败或登录即闪退，【必须严格按uname -m返回值选包】。
第一步：确认CPU架构
打开终端，执行：uname -m；记录返回值：x86_64 → 选x86_64包；aarch64 → 选arm64包；mips64el → 选mips64el包。
第二步：下载对应签名包
访问腾讯Linux QQ官网：https://www.php.cn/link/aaf8e720d64a8e289bfa63b46d4c79fe；下载文件名格式为：signed_linuxqq_3.2.28-1152_x86_64.deb（或其他对应架构后缀）。
第三步：安装并修复依赖
双击下载的.deb文件，调用UOS软件包管理器安装；若弹出“依赖不满足”错误，不要关闭窗口，立即打开终端执行：sudo apt --fix-broken install，再回到安装界面点击“重试”。
第四步：强制清除旧配置（关键防卡死步骤）
安装前务必执行：rm -rf ~/.config/tencent-qq ~/.cache/tencent-qq ~/.local/share/tencent-qq；否则极速版或新版首次启动会因读取旧缓存卡死在登录页。
