Ctrl+Shift+H 打开替换视图需先输入搜索内容并点击“Find All”才生效，否则 Replace All 无效；Mac 用户注意 Cmd+Shift+H 可能需加 Fn 键；关闭 Match Case 和 Whole Word 以避免变量替换遗漏，正则替换推荐用 $1 配对括号、禁用 \1；Replace All 后必须手动保存或开启 Auto Save，否则修改不持久。
Ctrl+Shift+H 打开的是替换视图，不是搜索视图
很多人按 Ctrl+Shift+H 后输完关键词直接点 Replace All，结果没改任何文件——因为这个快捷键默认进入的是「替换」面板，但不会自动执行搜索。它只预设了两个空输入框，不触发匹配扫描。
必须先在左侧搜索框里输入内容，再按 Enter 或点击右上角的放大镜图标（Find All），VS Code 才会高亮所有匹配项；只有这时，右侧替换框和 Replace All 按钮才真正生效。
- 如果面板右下角显示
0 results，说明根本没执行扫描，不是没找到，是压根没搜 - Mac 用户注意：
Cmd+Shift+H在部分外接键盘上需加Fn键才能触发 - 面板顶部若显示灰色“文档”图标，说明当前仍处于「当前文件」模式，需点击右上角 ⋯ → 勾选「在文件中查找」
变量名替换必须关掉 Match Case 和 Whole Word
想把 userList 改成 users，但只替换了部分？大概率是 Match Case（Aa 图标）或 Whole Word（\ 图标）被意外启用。
变量名通常大小写敏感但不一定是整词：比如 userList 出现在 const userList = [] 里是整词，但在 userList.map 或 JSON.stringify(userList) 里也是合法匹配；但如果开了 Whole Word，userList 就不会匹配 userList.map 中的点号后部分。
- 日常变量重命名，建议关闭 Aa 和 \ 两个按钮，只留 .*（正则）按需开启
- 如果真要确保只换独立变量（不碰
userListId这类），用正则\buserList\b更可靠，而非依赖 UI 的 Whole Word - 大小写开关开着时，
UserList和userList被视为不同项，批量改名前务必确认项目命名规范是否统一
正则替换变量时 $1 引用必须配对括号，且不能用 \1
想把 const userList = ... 替成 const users = ...，写正则 const\s+(userList)\s+= 然后替换为 const s = 是错的—— 只捕获 userList 字符串本身，s 会被解析为「捕获组 1 + 字母 s」，而 VS Code 不支持这种拼接语法，它会静默截断成 ，后面 s = 当普通文本输出。
正确做法是把整个目标名放进括号，或者用 $&（代表整个匹配）：
- 搜索：
const\s+userList\s+=，替换：const users =（不用正则也够用） - 搜索：
(const\s+)userList(\s+=)，替换：$1users$2（确保括号严格配对，无非捕获组干扰） - 搜索：
userList（不带 const），替换：users，再人工检查上下文是否误改字符串字面量 - 绝对别写
\1，VS Code 只认$1、$&、$$（输出字面量 $）
Replace All 不保存文件，改完必须 Ctrl+S 或开 Auto Save
点了 Replace All 后，编辑器标签页左上角出现 ● 圆点，说明变更还在内存里，没写入磁盘。关掉文件、切分支、甚至重启 VS Code，这些修改都会丢失。
这不是 bug，是设计：VS Code 默认把替换当临时编辑操作，避免误操作直接污染工作区。
- 最稳妥做法：替换完成后，逐个文件按
Ctrl+S保存 - 想一劳永逸：打开
File > Auto Save，设为afterDelay（推荐 1000ms） - 如果批量改了几十个文件，别靠眼睛找 ●，用命令面板
Ctrl+Shift+P输入「Save All」一键保存全部已修改文件 - Git 用户注意：未保存的替换不会出现在
git status里，别以为改完了就等于提交了
全局变量替换最难的从来不是怎么打字，而是确认每个匹配都是你想要改的上下文——比如 userList 在注释里、字符串里、正则字面量里，都可能被一并扫中。别跳过 Find All 后的手动抽查，尤其第一屏和最后一屏的匹配项。
