使用ctrl+shift+h或cmd+shift+h打开「在文件中替换」面板，需确保工作区已通过open folder加载根目录、排除规则未误拦目标文件、正则模式未误开，并在文件包含框中限定类型，替换前须人工核验上下文。
直接用 Ctrl+Shift+H（Windows/Linux）或 Cmd+Shift+H（macOS）打开「在文件中替换」面板，输入内容后点「全部替换」即可生效——前提是工作区已正确加载、排除规则没误拦、且没误开正则模式导致字面匹配失败。
确认工作区已加载顶层文件夹
全局替换只作用于当前打开的文件夹（不是单个文件，也不是 ZIP）。如果左下角状态栏显示“未打开文件夹”或只显示一个文件名（如 index.ts），说明搜索范围为空或极小。必须通过 File → Open Folder… 打开项目根目录（例如 my-app/），否则所有替换操作都无效。
- 多根工作区需确认所有目标文件夹都已加入，且未被
files.exclude隐藏 - 检查
.gitignore或.vscode/settings.json中的search.exclude是否意外排除了你要改的目录（如src/） - 默认排除
node_modules、dist、.git等，若真要搜它们，得清空「文件排除」字段或填!node_modules/**
避免正则误开导致搜不到字面字符串
很多人输 console.log 却没结果，是因为搜索框右侧的 .* 图标被点亮了——此时 . 被当正则元字符处理，log 里的 o 也可能被当成量词误解析。日常纯字符串替换，应确保 .* 图标未高亮，同时关掉 Aa（大小写敏感）和 \（全字匹配），除非你明确需要这些行为。
- 想精确替换独立单词（如只换
user，不碰username），点\按钮，或手动写\buser\b并点亮.* - 若必须用正则，记得所有特殊字符（
.、+、?、(、)等）在搜索框中都要双反斜杠转义：console\.log才能匹配字面值 - 替换框里
\n表示换行，\t表示制表符，\$表示字面美元符；捕获组必须用$1，不是\1或${1}
限定文件类型防止误改无关文件
直接全局替换容易把 .md、.json 甚至 package-lock.json 里的字符串也改掉。关键是在「文件包含」输入框中显式指定后缀或路径：
- 只改 TypeScript 文件：填
*.ts或src/**/*.ts - 只改 CSS：填
*.css，要跳过旧样式可加排除legacy.css - 只改 JS 和 TS：填
*.{js,ts}（注意花括号语法支持） - 多个条件用英文逗号分隔，如
src/**/*.{ts,tsx},tests/**/*
这些过滤仅对本次搜索有效，不会污染项目配置。
替换前必须人工核验上下文
Replace All 是直接写入内存的批量操作，没有预览 Diff，也没有一键撤回跨文件修改的能力。VSCode 不会区分注释、字符串字面量或代码逻辑——它只认文本匹配。
- 先按
Enter或点「在文件中查找」，看左侧结果树是否只有你预期的那些文件 - 逐个点击匹配项前的 ▶ 展开上下文，确认前后几行是真实代码（比如
user.name可以换，但// user is deprecated就不该动） - 对高风险替换（如改变量名），先小范围测试：限定单个文件或子目录，再逐步扩大
- 操作前提交 Git，替换后立刻运行
git diff检查变更范围，尤其注意 JSON、HTML 属性值、正则字面量等易被连带误伤的位置
真正难的不是怎么输正则，而是判断某处匹配该不该动——VSCode 没有语法树感知能力，这点永远要靠人盯。
