<p>Ctrl+Shift+R（Windows/Linux）或 Cmd+Shift+R（macOS）是项目级正则替换快捷键，需手动启用 .* 模式、正确转义元字符、确认 Scope 范围、预览匹配项，并优先考虑结构化搜索避免误替。</p>
Ctrl+Shift+R 是唯一能跨文件正则替换的快捷键
别用 Ctrl+R，它只在当前文件里动；Ctrl+Shift+R（Windows/Linux）或 Cmd+Shift+R（macOS）才是项目级入口。按完后光标默认落在「Find」框，但此时正则模式未启用——必须先点旁边 .* 按钮，否则输入的 .、+、? 全当普通字符处理。
常见错误现象：
- 搜
user.id却匹配到userid或userXid：没开正则，或没转义点号 → 应写成user\.id - URL 中
https://api.example.com?version=2搜不到：? 和 = 是正则元字符，需写成https://api\.example\.com\?version\=2 - 粘贴报错信息
Cannot read property 'data' of undefined直接搜失败：单引号和点号都得手动加\'和\.
搜索范围必须手动确认，不能信默认值
右上角 Scope 下拉菜单默认显示 All Places，但这只是上次操作的残留状态。实际可能被设成 Current File 或某个子目录，导致部分模块完全漏扫。
实操建议：
- 点开
Scope下拉菜单，逐项核对：是否意外包含node_modules或dist？这些目录默认被排除，但若你之前自定义过 Scope，就得手动剔除 - 想限定在
src/下操作？选Directory，再点击文件夹图标定位路径，别靠记忆输字符串 - 如果项目用了
.gitignore，WebStorm 会自动跳过其中路径，但某些自定义 excluded folders 需在Settings > Directories里检查
替换前务必点「Find」预览所有匹配项
直接点 All Files 是高危操作。WebStorm 的 Java 正则引擎不区分语法角色，console.log('user.id') 和 console.log(user.id) 在它眼里完全一样。
关键检查点：
- 预览窗口里，重点看匹配项是否落在双引号
""、单引号''、注释//或正则字面量/.../内部 - 若发现命中了字符串字面量（比如
"user.id"），说明正则太宽泛，应加单词边界\buser\.id\b或启用Words only - 捕获组写法要对：用
()包裹要复用的部分，替换时写$1、$2，不是\1—— WebStorm 不认后者
换行符、制表符必须用界面插入，不能手敲 \n 或 \t
WebStorm 不识别 JavaScript 风格的转义序列。手敲 \n 就是两个普通字符 \ 和 n，根本不会匹配真实换行。
正确做法：
- 点击搜索框右侧的
↓图标 → 选「Insert line break」插入真实换行符 - 同理，制表符选「Insert tab character」，别复制粘贴空格凑数
- 中文标点或 Unicode 字符（如
[\u4e00-\u9fa5]）可直接输入，但注意^、$在多行模式下才锚定行首尾，需额外勾选Match newline
Ctrl+Shift+Alt+S）比正则更安全。当你想改 array.forEach(...) 调用，而不是所有含 forEach 的文本，正则会误伤字符串和正则字面量，而结构化搜索基于 AST，天然跳过这些“假阳性”。 
