ctrl+shift+r（win/linux）或cmd+shift+r（macos）是webstorm全局替换快捷键，因ctrl+r仅限当前文件替换，而前者默认搜索整个项目并支持scope范围切换、正则替换及预览验证。
Ctrl+Shift+R（Windows/Linux）或 Cmd+Shift+R（macOS）是 WebStorm 项目全局替换的正确快捷键。
为什么不是 Ctrl+R？
Ctrl+R 只作用于当前打开的文件，很多人误以为它能跨文件批量改，结果只改了眼前这一个文件，其他地方全漏掉。这个键位在文档里明确叫 “Replace in File”，不是 “Replace in Path”。
- 按
Ctrl+R后界面顶部出现替换框，左下角会显示 “In File” 范围提示 - 按
Ctrl+Shift+R后顶部是 “Replace in Path”，右上角有 Scope 下拉菜单，默认是 “All Places” - 若误选成 “Current File” 或 “Directory” 但路径填错，也会导致部分文件没被扫到
替换前必须检查的三项设置
直接点 “Replace All” 是高危操作，尤其改变量名、API 路径或 JSON 键时，容易误中字符串、注释、正则字面量或模板语法。
-
Match case：大小写敏感能避开
user.id和User.id混淆，但别盲目关——比如改console.log就得开它 -
Words only：避免搜
id时命中userId或identifier；但改user.id→user.userId时就得关掉，否则.id不会被单独匹配 -
File mask：比如只改
*.ts或src/**，比用 Scope 更轻量；但 Scope 支持自定义并保存，适合长期复用（如 “Backend API Files”）
粘贴字符串进搜索框会出问题吗？
会。WebStorm 对手敲的 .、[、+ 会自动转义成 \.、\[、\+，但**粘贴进来的原样保留**，不加任何转义。
- 想搜
user.id字符串？必须手动写成user\.id，否则当正则匹配，可能命中userXid - 搜 URL 中的
https://api.example.com？斜杠不用转义，但.和?得处理：https://api\.example\.com\?v= - 从控制台复制报错信息如
Cannot read property 'data' of undefined？单引号和点号都要加反斜杠
真正麻烦的不是找不到怎么替，而是替完才发现 "user.id" 字符串、/user\.id/g 正则、Vue 模板里的 {{ user.id }} 全被改了。建议先用 Ctrl+Shift+F 预查上下文，再进替换流程；改完务必运行类型检查（如 TypeScript tsc --noEmit）和静态分析（如 phpstan 或 eslint），注解、SQL 片段、HTML 属性值这些地方最容易被漏掉。
