ctrl+shift+r 全局替换需手动确认 scope（非 current file）和 regex 开关（.∗ 按钮），粘贴内容须转义特殊字符；误操作、未预览、忽略上下文、未设 match case/words only、未用结构化搜索改语法结构，均易引发运行时错误。
Ctrl+Shift+R 之前必须确认 Scope 和 Regex 状态
全局替换不是按下 Ctrl+Shift+R 就自动生效，它默认用的是 All Places，但这个值可能被上次操作污染。点开右上角 Scope 下拉菜单，手动确认当前选中的是目标目录或模块，而不是 Current File——否则你按了快捷键，实际只改了当前打开的 tab。
Regex 开关必须手动点 .* 按钮启用，WebStorm 不会因为你在搜索框里写了 ^ 或 \d 就自动识别为正则。粘贴进来的字符串（比如从控制台复制的 Cannot read property 'data' of undefined）完全不转义，.、'、? 全当字面字符处理，结果要么搜不到，要么误匹配 userXid 这类内容。要搜字面量 user.id，必须手写成 user\.id；搜 URL 中的 https://api.example.com，得写成 https://api\.example\.com。
- 误按 Ctrl+R 而非 Ctrl+Shift+R：只改当前文件，其他地方毫无反应
- Scope 选错为 Current File：快捷键失效，变成单文件操作
- 没点 .* 就输
\d+：WebStorm 当作普通文本搜，根本不会匹配数字 - 粘贴
console.log后直接点 Find：如果项目里有"console.log"字符串，它也会被命中
预览比替换更重要：先看上下文再动手
点 Find 后弹出的匹配列表不是装饰，是唯一能提前发现灾难的地方。重点扫三类上下文："user.id"（字符串字面量）、/user\.id/g（正则字面量）、{{ user.id }}（模板语法）。这些地方一旦被改，运行时就报错，但普通文本替换无法区分。
勾选 Match case 可避开 User.id 或 USER.ID；勾选 Words only 能防止搜 id 时命中 userId，但改 user.id → user.userId 时得关掉它，否则 .id 不会被单独识别为词边界。
- 点 Replace All 前没点 Find：90% 的误替换发生在这一步跳过
- 忽略双引号/单引号包裹的内容：字符串里的
"data"被改成"dataUrl"，逻辑就断了 - 没勾 Search in Comments and Strings：注释里写的
// user.id is required就漏掉了
正则捕获组用 $1 不用 \1，换行符不能手敲 \n
WebStorm 用 Java 正则引擎，捕获组必须用 、 引用，写 无效。比如把 const foo = 123; 改成 let foo = 123;，搜 const (\w+) = (.*);，替换成 let = ;。鼠标悬停在 .* 按钮上点「显示表达式帮助」，能实时看到分组解析，比盲试快得多。
换行符、制表符别手输 \n 或 \t——WebStorm 不识别 JS 风格转义。点搜索框右侧 ↓ 图标，选「插入换行符」或「插入制表符」，它会生成正确的不可见字符。
- 写
\1替换：WebStorm 当作普通文本，$1 才是正确反向引用 - 手敲
\n搜换行：根本不会匹配，必须用插入功能 - 用
[\s\S]*跨行匹配：容易吞掉不该动的代码块，慎用
该用结构化搜索时别硬扛正则
当你改的是函数调用、变量声明、if 结构这类有语法含义的内容，普通查找替换就不可靠。比如想把所有 array.forEach(item => {}) 改成 for (const item of array)，正则会误中 "forEach" 字符串或 /\.forEach\(/ 正则字面量。
这时必须用 Ctrl+Shift+Alt+S 打开结构化搜索，它基于 AST，天然过滤字符串、注释、正则字面量。模板写 array.forEach($item$ => {$body$})，就能精准匹配语法节点，跳过所有干扰项。
- 改
console.log→console.debug：可用正则，但得加console\.log(?!\()避免命中"console.log" - 改
var→const：涉及作用域和初始化逻辑，必须用结构化搜索 - 改 JSX 属性名如
className→class：普通替换会改错className="foo"里的字符串值，结构化搜索可限定在属性位置
真正难的不是怎么输正则，而是判断这次改动到底属于纯文本替换，还是已经踩进语法层面——后者一错就是运行时报错，而且很难通过 grep 发现。
