WebStorm项目全局替换快捷键是Ctrl+Shift+R（Win/Linux）或Cmd+Shift+R（macOS），因Ctrl+R仅限当前文件，而前者支持Scope范围切换、正则替换及预览验证。
WebStorm 里不能靠 Ctrl+F 或 Ctrl+R 做跨文件批量替换——它们只作用于当前文件，真要改整个项目，必须用 Ctrl+Shift+R（Windows/Linux）或 Cmd+Shift+R（macOS）。
Ctrl+R 和 Ctrl+Shift+R 的区别到底在哪
很多人按 Ctrl+R 后点了 “Replace All”，结果只改了眼前这个文件，其他几十个地方全没动。这是因为 Ctrl+R 固定绑定为 “Replace in File”，界面左下角始终显示 “In File”；而 Ctrl+Shift+R 才是 “Replace in Path”，右上角有 Scope 下拉菜单，默认是 “All Places”。
- 误选 Scope 为 “Current File” 或填错 Directory 路径，会导致部分文件被跳过
-
Ctrl+Shift+F是查找入口，Ctrl+Shift+R是替换入口，两者不可互换 - 按完
Ctrl+Shift+R后光标自动落在 “Find” 框，不用再手动点进去
粘贴字符串进搜索框为什么经常搜不到
WebStorm 对手敲的 .、[、+ 会自动转义成 \.、\[、\+；但**粘贴进来的原样保留**，不加任何转义。所以你复制 user.id 进去，它就真按正则语义去匹配 userXid 这类内容。
- 想搜字面量
user.id？必须手动写成user\.id - 搜 URL 如
https://api.example.com？得写成https://api\.example\.com，其中.和/都要处理（/不强制转义，但习惯加上更稳） - 从控制台复制报错
Cannot read property 'data' of undefined？单引号和点号都得加反斜杠：'data'→\'data\'
怎么避免把字符串、注释、正则字面量一起改掉
直接点 “Replace All” 是高危操作。比如把 user.id 替成 user.userId，很容易连 "user.id" 字符串、/user\.id/g 正则、Vue 模板里的 {{ user.id }} 全干掉。
- 务必先点
Find »预览所有匹配项，看上下文是否全是代码逻辑 - 勾选
Match case可避开User.id和user.ID混淆 - 勾选
Words only能防止搜id时命中userId，但改user.id → user.userId时得关掉它，否则.id不会被单独识别 - 验证是否改全：替换完用
Ctrl+Shift+F重新搜原字符串，并勾选Search in Comments and Strings
什么时候该放弃文本替换，改用结构化搜索
当你改的是函数调用、变量声明、if 结构这类有语法含义的内容，而不是纯文本，普通替换就不可靠了。比如想把所有 array.forEach(item => {}) 改成 for (const item of array)，用正则会误中 "forEach" 字符串。
- 用
Ctrl+Shift+Alt+S打开结构化搜索，它基于 AST，天然过滤字符串、注释、正则字面量 - 模板示例：
$array$.forEach($param$ => $body$)只匹配真实调用，不碰字面量 - JS/TS 中的类型声明（
interface User { id: number }）、JSDoc（@param {User} user）也得靠结构化搜索或手动检查，普通文本替换无效
真正麻烦的不是找不到怎么替，而是替完才发现模板字符串里、SQL 片段中、HTML 属性值里还藏着没动的旧写法。Scope 设置、转义规则、预览习惯，这三样漏一个，就容易返工。
