Shift+F6可安全重命名变量并自动更新所有引用；手动替换易遗漏头文件声明、构建脚本符号、注释字符串及宏间接使用处，且无法精准识别作用域。
直接按 Shift+F6 就能安全重命名变量，CLion 会自动更新所有引用位置，包括头文件、源文件、CMakeLists.txt 甚至字符串里的字面量（如果主动勾选）。
重命名变量时为什么不能手动改？
手动替换容易漏掉以下几类地方：
- 头文件中声明的变量名（比如
extern int counter;） - CMake 或构建脚本里硬编码的符号名（如
set(SOURCE_FILES main.cpp utils.cpp)中不涉及，但若写成add_definitions(-DUSE_COUNTER_V2)就可能误触） - 字符串或注释里恰好同名的文本（比如
// counter is deprecated），这类不会被编译器检查，但影响可读性 - 宏定义展开后间接使用的变量（较少见，但存在风险）
而 Shift+F6 默认只改“代码中实际引用该变量的位置”，更精准；勾选 Search in comments and strings 后才扩展到非代码区域。
Shift+F6 按下后弹出的对话框里关键选项
按下 Shift+F6 后，光标所在变量高亮，输入新名并回车即完成。但若想控制范围或预览，可再按一次 Shift+F6 打开完整对话框：
-
Scope：默认是整个项目，可缩小为当前文件、当前模块或自定义路径 -
Search in comments and strings：勾选后连注释和字符串里的同名文本也一并替换（慎用，尤其当变量名是常见英文单词时） -
Preview：强烈建议点它，会在下方工具窗口列出所有将被修改的位置，确认无误再点Refactor
例如把 user_id 改成 userId，若没预览，可能误把 "user_id not found" 也改成 "userId not found" —— 这未必是你想要的。
重命名失败的常见信号和应对
CLion 在重命名过程中遇到冲突会弹窗，典型情况包括：
- 目标名称已在同一作用域内被占用 → 会提示“Name is already used”，需换名
- 变量被宏包裹（如
#define ID user_id）→ CLion 不处理宏展开，会跳过，但提示“Unresolved reference”类警告 - 跨语言混用（如 C++ 代码调用 Python 脚本里写的变量名）→ 不在 IDE 索引范围内，自然不会改
- 变量名出现在
constexpr字符串拼接中（如std::string_view{"user_id"}）→ 默认不改，除非勾选了Search in strings
此时别急着点 Anyway refactor，先看 Open in Find Tool Window，人工核对几处关键上下文是否合理。
最易被忽略的是作用域嵌套：比如在 lambda 内部声明了同名变量，Shift+F6 默认只重命名外层变量，不会动 lambda 里的——这其实是正确行为，但新手常误以为“没生效”。得确认光标落在哪个声明上再操作。
