CLion重构需满足语义条件而非仅记快捷键：Shift+F6重命名须光标定位完整符号；Ctrl+Alt+Shift+T是重构菜单入口，需选择操作；Ctrl+Alt+M提取函数要求代码逻辑闭包；Alt+Delete为安全删除，依赖AST解析。
CLion 重构快捷键不是“按一次就完事”，而是需要配合上下文、光标位置和弹出的对话框才能生效；直接硬记组合键但忽略触发条件，90% 的情况会失败。
Shift+F6 重命名必须先选中或定位到符号
很多人按 Shift+F6 没反应，是因为光标停在空行、注释里，或只选中了部分字母（比如只选了 getUser 中的 get）。它只对完整符号名有效：类名、函数名、变量名、参数名。
- 正确做法：将光标放在
std::string name的name上（不选中，仅停留），再按Shift+F6 - 如果符号被多次使用，CLion 默认在「整个项目」范围内重命名；想限制范围，按
Shift+F6后点More options，改作用域为「当前文件」或「模块」 - 注意：重命名类时，IDE 会自动提示是否同步重命名同名头文件（如
User.h→Person.h），这个提示默认开启，但容易被误点跳过
Ctrl+Alt+Shift+T 是重构入口，不是单个操作
Ctrl+Alt+Shift+T 打开的是重构菜单面板，不是执行某个具体动作。它列出所有当前上下文可用的重构项，比如光标在函数体内时显示「Extract Function」，在类声明内时可能显示「Pull Members Up」。
- 常见误操作：按完快捷键后直接敲回车——这会应用第一个选项（通常是「Rename」），而非你想要的「Extract Variable」
- 安全做法：按
Ctrl+Alt+Shift+T后用方向键高亮目标项（如Extract Function），再按回车；或者直接输入首字母快速筛选（如输e定位到 Extract） - 某些重构（如「Change Signature」
Ctrl+F6）支持预览，但仅当函数已被声明且有调用处时才激活；未定义的函数上按Ctrl+F6会静默失败
Ctrl+Alt+M 提取函数对代码块有强约束
Ctrl+Alt+M 不是任意选几行就能提，它要求所选代码能构成一个逻辑闭包：不能跨作用域（比如选了 if 块开头但没选完大括号）、不能含未声明变量、返回值需可推导。
- 典型失败场景：选中
int x = a + b; return x * 2;，但a和b在外层作用域声明 → CLion 会把a、b自动加为参数，但如果你没注意到，生成的函数签名可能带冗余参数 - 参数顺序默认按出现顺序排列，但你可以进对话框手动拖拽调整；返回类型若未明确（如原代码无
return），CLion 可能设为void，需手动改成int - 提取后，原调用处插入的是未声明的函数调用，如果目标位置上方没声明，编译会报
use of undeclared identifier—— 这时要检查对话框里的「Declare function here」选项是否勾选
Alt+Delete 安全删除容易被当成普通删键
Alt+Delete 不是删除选中文本，而是触发「Safe Delete」重构：它会扫描整个项目，确认该符号是否被引用，再决定能否删、删哪些关联文件（如头文件、CMakeLists.txt 里的源文件路径）。
- 危险操作：在 .h 文件里选中一个函数声明，按
Delete（非Alt+Delete）→ 直接删文本，但 .cpp 里实现还在，编译失败 - 安全做法：先按
Alt+Delete，看弹窗里「Usages found」是否为空；如果不为空，它会列出所有引用点，你可以取消勾选某些条目避免误删 - 特别注意：删类时，CLion 默认会尝试删同名 .h/.cpp 文件，但如果 CMakeLists.txt 里用了
glob匹配（如file(GLOB SOURCES "*.cpp")），它无法识别，删完仍会编译失败
重构真正难的不是快捷键本身，而是 IDE 对代码语义的理解边界——它依赖准确的 AST 解析，而 C++ 模板、宏、未包含头文件都会让这些快捷键“失灵”。遇到没反应，先检查语法是否正确、头文件是否 include 完整、有没有红色波浪线卡住解析。
