F2重命名才是安全的全局变量替换方式，正则替换是字符串暴力覆盖易破坏逻辑；F2不生效主因是语言服务未就位、配置缺失或光标未置声明处；正则仅用于字符串/跨语言等F2不可用且风险可控场景。
F2 重命名才是安全的全局变量替换方式，正则全局替换只是字符串暴力覆盖，极易破坏代码逻辑。
为什么 F2 重命名不生效？先看语言服务是否就位
按 F2 没反应、只改当前文件、或改完没跳转——不是快捷键坏了，是 VS Code 没把那个名字识别成“可重命名的符号”。关键检查点：
- 右下角状态栏必须显示
TypeScript、Python等具体语言，不能是Plain Text或Auto-detect - TS/JS 项目根目录要有
tsconfig.json或jsconfig.json，且include覆盖源码路径（如"src/**/*"） - 光标必须落在变量**声明处**（如
const userId = ...中的userId），而非字符串内、注释里、点号后（user.userId的userId不触发） - 按
Ctrl+Click（Windows/Linux）能跳转到定义，底部状态栏显示类似1 definition, 4 references—— 没这行字，F2就是假重命名
什么时候必须用正则全局替换？
当 F2 确实不可用，且你明确知道风险可控时才上正则。典型场景：
- 变量名出现在字符串、模板字面量、JSON 键、注释中，语言服务无法索引（如
"user_id"或// legacy user_id） - 跨语言混用，比如 TS 文件里硬编码了 Python 变量名（
python_var_name） - 批量清洗遗留代码，如统一把
my_.*_handler改为handle.*，这类带固定模式的重构
操作要点：
- 打开
Ctrl+Shift+H（全局替换） - 在“文件包含”填
*.ts或src/**/*.py，排除node_modules、dist、__pycache__ - 启用正则模式（点
.*图标），搜索写\bmy_([a-zA-Z0-9]+)_handler\b，替换写handle$1 - 务必勾选“全字匹配”（
AaBb）或用\b包裹，避免把username里的name替掉
Ctrl+D 和 Ctrl+Shift+L 是什么定位？
这两个是**单文件内**的快捷选中，和“全局”无关：
-
Ctrl+D：逐个选中光标所在单词的后续完全匹配项（区分大小写、不跨作用域），适合快速修几个相邻位置 -
Ctrl+Shift+L：一次性选中当前文件中所有完全相同的字符串（不管是不是变量），适合临时调试变量名、局部常量等，但会误中字符串和注释
它们都不依赖语言服务，也不跨文件，更不校验语法。用它们改变量名，等于放弃类型安全，只适合脚本式快速修补。
最容易被忽略的细节
真正卡住人的从来不是怎么按快捷键，而是：tsconfig.json 或 pyproject.toml 配置后没重启 TS Server / Pyright；语言服务日志里早报了 Failed to resolve import 却没去看；或者变量本身是 any 类型、未声明直接赋值（foo = 123）、或藏在 eval() 里——这些情况下，F2 退化为纯文本替换，但你根本意识不到。
