靠得住，但需依赖语言服务器——Shift+F2触发的语义级重命名能否跨文件、识别作用域，取决于对应语言扩展（如TypeScript Server、Pylance）是否提供准确符号信息。
VSCode 里重命名变量到底靠不靠谱？
靠得住，但得用对方式——Shift+F2（Windows/Linux）或 Fn+Shift+F2（macOS）触发的「重命名符号」是 VSCode 原生支持的语义级重命名，不是简单文本替换。它依赖语言服务器（如 TypeScript Server、Python Pylance、Rust Analyzer），所以能否跨文件、是否识别作用域，完全看对应语言扩展有没有提供准确的符号定义和引用信息。
为什么改了变量名，有些地方没跟着变？
常见原因有三个：
- 当前文件没被语言服务正确激活（比如
.js文件没开javascript.implicitProjectConfig.checkJs，或没加// @ts-check） - 变量是字符串拼接、
eval、with语句或动态属性访问（如obj[variableName]），语言服务无法静态推导 - 目标变量在不同作用域中同名（比如函数参数和外层变量同名），VSCode 默认只重命名当前作用域内绑定的符号，不会越界
验证方法：把光标停在变量上，看底部状态栏是否显示「1 definition, 3 references」之类的信息。没有，说明语言服务还没接管这个符号。
怎么确保重命名真正全局生效？
关键在启动前做两件事：
- 确认已安装并启用对应语言的官方扩展（如
ms-python.python、ms-vscode.vscode-typescript-next） - 检查工作区根目录是否有有效配置文件（
tsconfig.json、pyproject.toml、rust-project.json），没有的话语言服务可能降级为“仅当前文件”模式 - 对 JavaScript/TypeScript 项目，打开
settings.json加上："javascript.preferences.renameShorthandProperties": true,
"typescript.preferences.renameShorthandProperties": true
重命名过程中，编辑器会高亮所有可安全修改的位置；如果某处没被选中，鼠标悬停会提示「Not part of the symbol」——这时候别硬改，手动处理更稳妥。
遇到“无法重命名”的报错怎么办？
典型错误信息是：Cannot rename symbol: No definition found for 'xxx' 或 Renaming is not supported for this location。
这不是 VSCode 的 bug，而是语言服务明确拒绝介入：
- 变量定义在
node_modules或未开启的库声明文件中（如.d.ts），默认禁止修改 - 当前文件后缀与语言模式不匹配（比如写 TypeScript 却用了
.js后缀，右下角语言模式要手动切到TypeScript） - 项目太大，语言服务还在初始化（等右下角 TypeScript 图标停止旋转再试）
临时绕过办法：用 Ctrl+H（Cmd+H）开启「在文件夹中查找」，勾选「使用正则表达式」和「全字匹配」，但必须人工核对每一处——尤其是引号内、注释里、模板字符串中。
最常被忽略的一点：重命名操作本身不提交 Git，也不自动格式化。改完记得跑一遍 prettier 或 eslint --fix，否则可能因空格、换行差异导致后续 diff 失控。
