Ctrl+Shift+R 是 Qt Creator 中重命名 C++ 符号的快捷键，需光标精准定位符号、Clangd 索引完整且符号已解析；若失败，可禁用 Clangd 或检查项目配置与文件名同步。
Ctrl+Shift+R 是 Qt Creator 里重命名变量和函数最直接的方式，但实际用起来常卡在“找不到匹配”或改完只局部生效——这基本不是操作错了，而是 Clangd 索引没跟上或配置冲突。
重命名符号的正确触发方式
把光标精准停在要改的变量名、函数名或类名上（不能在括号里、不能在注释中），然后按 Ctrl+Shift+R。这时名字会高亮并带红色边框，表示已进入重命名模式；直接输入新名，回车确认即可批量替换整个项目中所有匹配引用。
注意：必须是 C++ 符号（非字符串字面量、非宏定义）、且该符号已被 Qt Creator 正确解析（即没有报红）。如果光标悬停时看不到类型提示或跳转不到定义，Ctrl+Shift+R 很可能失效。
为什么有时提示“未找到匹配”
这是 Qt Creator 18.0+ 版本最常见的问题，根源在 Clangd 后端：
- Clangd 的
Background indexing没完成，或中途被中断，导致符号数据库不全 -
Use clangd开启状态下，某些模板、宏展开、跨模块依赖无法被准确索引 - 项目未正确加载
.pro或CMakeLists.txt，Qt Creator 根本没识别出源文件范围
临时解法：进 首选项 → C++ → Clangd，把 Use clangd 取消勾选（重启 Qt Creator）。虽然补全和跳转会变慢，但 Ctrl+Shift+R 就能稳定工作。
重命名类名时，头文件和源文件名不会自动同步
Qt Creator 默认只改代码里的符号引用，不改磁盘上的文件名。比如把 MyWidget 改成 CustomPanel，mywidget.h 和 mywidget.cpp 还是原名。
想连文件一起改，得手动操作：
- 先用
Ctrl+Shift+R改完类名和所有引用 - 右键点击
mywidget.h→ 重命名，改成custompanel.h - 同样重命名
mywidget.cpp→custompanel.cpp - 打开
.pro文件，确认SOURCES和HEADERS列表已更新（Qt Creator 通常会自动做这步，但务必检查）
漏掉文件名同步，编译时大概率报 file not found 或链接失败。
QML 和 Python 符号也能重命名，但路径不同
QML 类型（如自定义组件 MyButton）和 Python 脚本中的变量/函数，同样支持 Ctrl+Shift+R，但前提是语言服务已启用：
- QML：确保文件后缀是
.qml，且项目已启用 QML 支持（项目设置 → Run Settings → QML Debugging 不必开，但 QML 解析器得加载） - Python：需安装并启用 Python 插件（帮助 → 关于插件 中搜索 Python），否则快捷键无效
这两类重命名不会影响 C++ 符号，反之亦然——Qt Creator 按语言上下文隔离索引，混用时别指望一次改穿整个项目。
重命名看着简单，真正落地时卡点都在索引状态和文件系统一致性上。改之前先确认F2 能跳转到定义，改之后立刻检查 .pro 和磁盘文件名是否同步，比反复试 Ctrl+Shift+R 更省时间。 
