Atom 中安全重命名变量必须使用符号查找（Ctrl+R/Cmd+R）而非 Ctrl+H，因后者仅文本匹配易破坏作用域；跨文件重命名需依赖语言插件的 AST 解析与 Refactor > Rename Symbol 功能。
全工程替换变量不能只靠 Ctrl+H —— Atom 默认不识别语义，直接批量替换大概率破坏作用域、漏改或误改。
为什么 Ctrl+H 替换变量会出错
Atom 的 find-and-replace 包本质是文本匹配，不是符号解析。它不管 count 是局部变量、参数、字符串字面量还是注释里的词，只要字面匹配就替换。
- 函数内
let count = 0和全局const count = 42会被一视同仁 -
"count"或// count total items也会被改，引发运行时错误或逻辑错乱 - 跨文件时，
import { count } from './utils'中的count可能被替成别的名，但导出侧没同步改，导致 import 失败
安全替换变量必须用符号查找（Symbols View）
真正可靠的跨文件变量重命名，得靠 Atom 内置的符号系统，它依赖语言插件（如 language-javascript、atom-typescript）做 AST 解析。
- 快捷键：
Ctrl+R（Windows/Linux）或Cmd+R（macOS）打开当前文件符号列表 - 快捷键：
Ctrl+Shift+R（Windows/Linux）或Cmd+Shift+R（macOS）查找项目内所有引用位置 - 结果面板里显示每个匹配项的作用域（如 “in function foo”, “in class Bar”），可人工确认是否属于同一逻辑符号
- 右键点击某处引用 →
Refactor > Rename Symbol（需安装atom-ide-ui或nuclide类插件），才能触发语义级重命名
正则替换仅限“确定无歧义”的场景
如果坚持用 Ctrl+H + 正则，必须满足三个前提：变量名足够唯一、上下文可控、且已验证无副作用。
- 模式示例：
\bmyCounter\b（\b确保单词边界，避免匹配myCounterValue） - 替换字段写
totalItems，别用$1等捕获组——除非你真需要提取内容再重组 - 务必先点
Find All，检查右侧面板列出的每一处是否都该改；特别注意node_modules是否已被.atomignore或Exclude VCS Ignored Paths屏蔽 - 替换后立即执行
File > Save All（Ctrl+K S），否则未激活标签页里的修改不会落盘
容易被忽略的重构陷阱
最危险的不是找不到地方改，而是改了之后没人发现哪里崩了。
- TS/JS 里
export const count = 1被重命名后，所有import { count }必须同步更新——符号查找能追踪，正则做不到 - 动态属性访问如
obj[variableName]或eval('count++')永远不会被符号系统识别，得手动检查 - 配置文件、JSON、HTML 模板里的变量名（如
data-count）不属于代码符号，只能靠正则，但必须单独开一个作用域查 - Atom 不保存跨文件重命名的历史，
Ctrl+Z只撤回当前文件；改完建议立刻git diff扫一眼变更范围
