重构前必须先点击preview按钮查看所有待修改位置，再确认操作；预览支持rename等主流重构，可手动取消勾选、排除项，并需注意作用域和search in comments and strings等选项设置。
重构前必须看预览，否则容易改错范围或漏改引用
重构预览在哪触发
不是所有重构都支持预览，但 Rename、Change Signature、Extract Function、Move 等主流操作默认支持。只要执行这些重构（比如选中函数名按 Shift+F6），CLion 就会在弹出的对话框里显示 Preview 按钮 —— 不要点“Refactor”或“OK”，先点它。
常见错误现象：直接确认重构，结果只改了局部变量、没动头文件声明，或漏掉某个子类里的重写函数。
- 预览窗口本质是
Find工具窗口，里面列出所有将被修改的位置，带上下文代码片段 - 每条结果左侧有复选框，可手动取消勾选某几处（比如你确定某段字符串里的名字不该改）
- 按
Ctrl+0 X可快速排除已选中的项（注意不是字母 X，是数字 0 + 字母 X）
预览里看不到全部改动？检查作用域和搜索选项
默认预览只扫描当前项目（Project），但如果你在 Rename 对话框里没选对范围，或者没勾选 Search in comments and strings，部分引用就会被过滤掉。
使用场景：重命名一个全局常量 MAX_BUFFER_SIZE，但它的用法散落在 CMakeLists.txt、.h 注释、日志字符串里 —— 这些地方只有显式勾选对应选项才会出现在预览中。
-
Search in comments and strings：影响注释、字符串字面量里的匹配 -
Text occurrences（仅 Objective-C/部分语言）：搜纯文本文件，如 README、.md - 作用域下拉菜单可切到
Module或Directory，避免误改其他模块的同名符号
预览后执行失败或报冲突怎么办
点击 Refactor 后若弹出冲突对话框，说明 CLion 在改某处时发现语法歧义或无法自动推断（比如宏展开后的函数调用、模板特化里的重载名）。
此时不要直接点 Anyway refactor，优先点 In Find tool window —— 它会把冲突项高亮标红并跳转到具体行，你得人工确认是否该改、怎么改。
- 典型冲突：头文件里声明了
void foo(int)，实现文件里定义了void foo(int)和void foo(double)，你只想改第一个，但 CLion 模糊匹配了两个 - 参数类型不明确时（如
auto、decltype），Change Signature预览可能漏掉某些调用点 - 跨文件重构（如移动函数到新头文件）时，如果目标头文件未被当前 TU
#include，预览可能不显示该 TU 的修正
真正麻烦的不是预览打不开，而是你以为预览全了，其实它默认过滤掉了注释、字符串、非源码文件——这些地方一旦漏改，编译能过，但文档和日志就和代码对不上了。
