答案：VSCode中批量重命名变量应使用F2快捷键（或右键“重命名符号”），依赖语言服务器语义分析实现跨文件安全更新，而非Ctrl+H/Ctrl+Shift+H等文本替换；若F2失效，需检查语言模式、配置文件（如tsconfig.json）及扩展（如Pylance）是否就绪。
全局替换快捷键在 VSCode 中默认不生效？
VSCode 本身没有“全局替换变量名”的一键快捷键，Ctrl+H（Windows/Linux）或 Cmd+H（macOS）只是打开当前文件的查找替换面板。所谓“全局替换变量名”，实际依赖的是「重命名符号」功能，它会智能识别作用域、引用关系和语言语义，不是简单字符串替换。
用 F2 重命名才是安全替换变量名的正解
选中变量名后按 F2，VSCode 会基于语言服务器（如 TypeScript Server、Pylance、Rust Analyzer）分析该符号的所有引用位置，并高亮显示可编辑区域。输入新名称后回车，所有相关引用一次性更新。
- 只影响该变量实际作用域内被识别为同一符号的位置（比如不会误改同名字符串或注释）
- 支持跨文件重命名（前提是项目已正确配置语言服务，且文件在工作区中）
- 若
F2无响应，检查是否安装对应语言扩展（如 Python 需 Pylance，JavaScript/TS 需内置 TS 语言功能启用） - 部分语言（如纯
.js文件未启用 JSDoc 或类型标注）可能仅支持基础重命名，精度下降
Ctrl+Shift+H 是真·全局字符串替换，但风险极高
Ctrl+Shift+H（macOS 是 Cmd+Shift+H）打开「全局查找替换」面板，它对整个工作区执行文本级替换，不理解语法结构。
- 适合替换硬编码字符串、配置项名、CSS 类名等无语义上下文的内容
- 绝不能用于变量名：会把字符串中的同名文本、注释、JSON key、甚至其他变量名（如
user替换时误改username）一并替换 - 使用前务必勾选
Match Case和Whole Word（\b效果），否则灾难性后果立现 - 建议先点「Replace Preview」逐个确认，别直接点「Replace All」
为什么重命名有时只改了部分文件？
常见原因不是快捷键失效，而是语言服务未覆盖到那些文件：
- 文件未加入 VSCode 工作区（比如放在
node_modules或隐藏目录下） - 缺少
jsconfig.json或tsconfig.json，导致 JS/TS 项目无法推导模块关系 - Python 项目没启用 Pylance，或
pyright配置中禁用了rename功能 - 文件编码异常（如含 BOM）、语法错误过多，导致语言服务器跳过解析
重命名的可靠性高度依赖语言服务状态，而不是键盘按键本身。看到「No result」提示时，先看右下角语言模式是否正确，再检查输出面板里 Python 或 Typescript 的日志有没有报错。
