VSCode全局替换必须用Ctrl+Shift+H（Win/Linux）或Cmd+Shift+H（macOS），它支持限定文件类型、启用正则、预览结果，但默认扫描整个工作区，需手动设置“包含文件”如*.php避免误改非目标文件。
VSCode 全局替换不是靠 Ctrl+H 就能搞定的，真正高效重构得用 Ctrl+Shift+H，它能限定文件类型、开正则、预览结果——但默认不校验语义，乱换可能直接 break 项目。
全局替换必须用 Ctrl+Shift+H，不是 Ctrl+H
Ctrl+H 只在当前文件里找，Ctrl+Shift+H 才是跨文件批量改的入口。按完后注意看面板顶部的「包含文件」输入框，默认是空的，意味着搜整个工作区——这很危险，尤其当你想只动 PHP 文件却忘了过滤时，JSON、MD、配置文件全被卷进去。
- 必须手动填
*.php或**/*.ts，避免误伤非目标文件 - 如果项目混用多种语言（比如 PHP + JS + Python），建议先用
Ctrl+Shift+F预查一遍命中范围，再点「替换」展开面板 - 别依赖「全部替换」按钮一次清完：VSCode 不会跳过注释或字符串字面量，
userName在// userName is deprecated和const key = 'userName'里都会被换掉
正则模式才是精准替换的核心
纯文本替换只能应付命名一致的变量，但函数调用、属性访问、带前缀的常量，必须开 .* 图标启用正则。比如把所有 $this->user_name 改成 $this->userName，光搜 user_name 会连 config_user_name 一起拖下水。
- 安全写法：
\$this->user_name\b——\b锚定单词边界，排除config_user_name - 批量改函数参数：
api\.fetch\(([^)]+)\)匹配所有api.fetch(x)，替换为api.fetch($1, { cache: true }) - PHP 中改
mysql_*为mysqli_*，用mysql_([a-z]+)→mysqli_$1，比手动一个一个敲快十倍
替换前务必关掉 editor.formatOnSave
边替边保存，Prettier 或 ESLint 会立刻格式化刚改完的行，导致 diff 里全是缩进和换行变化，根本看不出你到底改了哪几个变量名。更糟的是，某些格式化规则（如解构赋值强制多行）会让替换后的代码语法错位。
- 临时关闭：
Ctrl+,打开设置，搜formatOnSave，取消勾选；或者快捷键Ctrl+K Ctrl+S查当前绑定，确认没被插件劫持 - 更稳做法：在项目根目录加
.prettierrc，设"printWidth": 100，避免默认 80 列把一行硬折断 - 替换完成后再统一格式化：
Shift+Alt+F全文件跑一遍，diff 干净，CR 也清爽
F2 重命名和 Ctrl+Shift+H 替换根本不是一回事
F2 是语义级重命名，依赖语言服务器识别作用域、类型、引用链；Ctrl+Shift+H 是纯文本暴力替换，不看上下文。想把 getUserById 函数名改成 findUserById，用 F2 安全；但要把所有 user_id 字段名（包括数据库 SQL、API 响应 JSON、PHP 数组键）统一换成 userId，F2 压根不管用。
-
F2失效常见原因：状态栏没显示TypeScript或Python，而是Plain Text；或项目缺tsconfig.json/pyproject.toml -
Ctrl+Shift+H的风险点：它不会跳过console.log('user_id')这种字符串里的内容，除非你手动加正则锚定 - 混合策略更可靠：先用
F2改函数/类/变量名，再用Ctrl+Shift+H+ 正则扫 SQL、JSON Schema、测试用例里的字段名
最易被忽略的点：全局替换没有「回滚快照」。VSCode 不像 Git 那样自动存每一步修改，一旦点错「全部替换」，只能靠 Ctrl+Z 撤回——但如果你已切到别的文件或保存过，就再也找不回来了。动手前先 git stash 或至少 Ctrl+Shift+P → File: Save All 留个底。
