qt资源文件必须显式添加到.pro的resources列表并运行qmake，否则:/路径无效；需确保.qrc路径正确、前缀以/开头、文件名纯ascii，且构建日志中出现rcc执行记录。
Qt Creator 里资源文件不是“用一下就行”的东西，它必须被编译进可执行文件才能生效——没加进 .pro 文件的 RESOURCES 列表，或者没正确构建，:/xxx 路径就永远是空的。
资源文件必须显式注册到 .pro 才能参与构建
很多人拖一个 .qrc 文件进项目，以为右键“添加到项目”就完事了，结果运行时图标全黑、QSS 中 background-image:url(:/...) 不显示。根本原因是：Qt 的构建系统根本不认识这个文件。
-
.qrc文件必须手动写进.pro的RESOURCES += xxx.qrc行里，哪怕只有一行也要写全路径（相对项目根目录） - 如果
.pro里用了变量（比如$$PWD），确保路径拼接后能真实定位到.qrc，例如：RESOURCES += $$PWD/resources/icons.qrc - 改完
.pro后必须点击“重新运行 qmake”（右键项目 → “Run qmake”），否则新增资源不会被 rcc 工具处理 - 构建时观察输出窗口是否有
rcc命令执行日志，没有就说明资源根本没编译进去
资源路径里的前缀和别名不是可选优化，而是引用前提
:/images/logo.png 这种写法之所以能用，是因为你在 .qrc 编辑器里设置了前缀 /images，且该文件确实放在那个前缀下。路径错误或前缀名打错一个字符，QIcon 就静默失败，不报错也不显示图。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 前缀必须以
/开头，比如/icons、/styles，不能写成icons或./icons - 别名（Alias）字段填了之后，引用路径就变成
:/icons/save，而不是真实文件名；但别名一旦设了，原始文件名改了也不影响代码——这是唯一推荐的引用方式 - QSS 里用资源图片时，
url(:/icons/close)的括号内路径必须和资源编辑器里显示的“Resource URL”完全一致，大小写、斜杠方向都不能错
中文路径或文件名会导致资源加载失败
Qt 的 rcc 工具在 Windows 和部分 Linux 环境下对 UTF-8 路径支持不稳定，即使资源编辑器能正常显示带中文的文件，构建后运行时也常返回空 QPixmap。
- 所有资源文件（.png、.svg、.qss 等）的文件名和所在文件夹名必须是纯 ASCII 字符，比如
icon_close.png，禁止关闭图标.png -
.qrc文件自身也不能用中文命名，像资源文件.qrc会直接导致 qmake 报错或跳过处理 - 如果已有中文资源，重命名为英文后，务必在资源编辑器中右键该文件 → “Remove”，再重新 Add File，否则旧路径残留仍会引发问题
真正麻烦的不是怎么加资源，而是当 QIcon(":/xxx") 返回空图标、QSS 背景消失时，你得知道该去哪查：先看 .pro 有没有 RESOURCES，再打开 .qrc 确认前缀和别名拼写，最后检查构建日志里有没有 rcc 输出——三者缺一不可。
