ctrl+shift+r（windows/linux）或 cmd+shift+r（macos）才是真正的多文件搜索替换入口，ctrl+r 仅作用于当前文件；需确认 scope 设置、转义特殊字符、预览匹配项、检查注释与字符串，并用结构化搜索提升安全性。
Ctrl+Shift+R（Windows/Linux）或 Cmd+Shift+R（macOS）才是真正的多文件搜索替换入口，Ctrl+R 只动当前文件，误用等于白改。
为什么 Ctrl+R 不能跨文件批量改
很多人按 Ctrl+R 后发现只改了眼前这个文件，其他地方纹丝不动——因为它的定位就是「Replace in File」。界面顶部会明确显示 In File，左下角也有提示。而真正扫全项目的操作，必须用 Ctrl+Shift+R，顶部显示的是 Replace in Path，右上角带 Scope 下拉菜单，默认值不等于安全值。
- 上次操作可能把 Scope 错设成
Current File或某个子目录，这次一按就漏掉大半代码 -
node_modules、dist、build默认被排除，但如果你手动建过自定义 Scope，得检查是否意外包含它们——否则索引卡顿、结果失真 - 按完快捷键后光标落在 Find 框，此时直接输内容不等于生效：若要用正则，必须先点旁边的
.*按钮启用模式
粘贴字符串进搜索框为什么总不对
WebStorm 对手敲的 .、[、+ 会自动转义成 \.、\[、\+；但你从控制台复制的 Cannot read property 'data' of undefined 或从代码里复制的 user.id，粘贴进去就是原样，. 和 ' 全当普通字符处理，根本不会触发正则匹配，也容易误中非目标位置。
- 搜
user.id字符串？必须手动写成user\.id，否则会匹配userId、userXid等 - URL 如
https://api.example.com?version=2，斜杠不用转义，但.、?、=得写成https://api\.example\.com\?version=2 - 从错误堆栈复制内容时，单引号、点号、括号都要补反斜杠，否则搜不到或搜偏
替换前不预览，90% 的人会改错注释和模板
直接点 Replace All 是高危动作，尤其改变量名、API 路径或 JSON 键时，"user.id" 字符串、/user\.id/g 正则、Vue 模板里的 {{ user.id }} 全可能被一锅端。
- 务必先点
Find »预览所有匹配项，看上下文是否合理——特别注意是否命中了注释、字符串字面量、正则字面量、JSDoc、HTML 属性值 - 勾选
Match case可避开user.id和User.id混淆；但改console.log这类大小写固定词时就得开它 - 勾选
Words only能防止搜id时命中userId；但改user.id → user.userId时就得关掉，否则.id不会被单独识别 -
File mask比 Scope 更轻量，比如只限定*.ts或src/**，适合一次性任务
替换完怎么确认没漏网之鱼
WebStorm 不会自动告诉你哪里没改到，尤其当目标字符串是合法标识符（如 data）、分散在测试文件、类型声明或 SQL 片段里时。
- 用
Ctrl+Shift+F（macOS 是Cmd+Shift+F）重新搜原字符串，返回零结果只是基础验证 - 要查注释和字符串里的内容，得额外勾选
Search in Comments and Strings - JS/TS 项目还得人工扫一遍
interface Data{}、@param {Data}、/* data is null */这类非执行上下文 - 大项目里若响应慢或漏文件，去
Settings > Editor > File Types确认.ts、.jsx是否被正确关联，否则这些文件压根不参与搜索
真正麻烦的不是找不到怎么替，而是替完才发现不该动的地方全动了——结构化搜索（Ctrl+Shift+Alt+S）能按语法树匹配，比纯文本更安全，但门槛略高；日常改动，宁可多点一次 Find »，也别信默认 Scope 和一键 Replace All。
