VS Code重命名功能依赖语言服务器（LSP）提供语义分析，若文件未被正确识别、LSP未启动或配置缺失（如tsconfig.json/jsconfig.json、pyproject.toml），则仅做简单文本替换；快捷键为F2（Mac需Fn+F2），务必检查状态栏语言模式、开发者工具控制台日志，并预览修改范围。
VS Code 的代码重构和重命名能力足够好用，但默认行为常让人误以为“没反应”或“重命名不彻底”——问题通常出在语言支持、文件关联或触发方式上，不是 VS Code 本身不支持。
重命名符号（rename）为什么只改了局部变量？
VS Code 的 rename 功能依赖语言服务器（LSP）提供语义分析。如果当前文件没被正确识别为对应语言，或 LSP 未启动/崩溃，rename 就只会做简单文本替换（即只改光标处），不会跨文件、不更新导入名、不处理别名。
- 检查右下角状态栏：确认显示的是正确的语言模式（如
python、typescript，而不是Plain Text） - 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），运行Developer: Toggle Developer Tools，看 console 是否有 LSP 连接失败日志 - TypeScript/javaScript 项目必须有
tsconfig.json或jsconfig.json才能跨文件重命名；Python 需安装并启用Pylance（非Python扩展默认的 Jedi） - 重命名快捷键是
F2（windows/linux）或Fn+F2（Mac），不是鼠标右键菜单里的“重命名符号”项（那个有时会失效）
如何安全地重命名导出的函数或类（含跨文件引用）？
关键在于让语言服务“知道这是可导出的符号”，且调用方正确 import。以 TypeScript 为例：
- 确保导出写法是
export function foo()或export class Bar，而非export default后接匿名函数/类（后者重命名后可能丢失类型推导） - 调用方需使用具名 import：
import { foo } from './utils'；若用import utils from './utils'再utils.foo，重命名不会更新utils.foo - 重命名前先保存所有相关文件（
Ctrl+S），否则 LSP 可能读取缓存旧内容 - 重命名后留意底部弹出的“Preview changes”窗口——它会列出所有将被修改的位置，**务必点开检查**，尤其注意是否遗漏了字符串中的硬编码引用（如日志里的
'foo'）
Python 中重命名失败的常见原因
Python 的符号重命名比 JS/TS 更容易卡住，主因是动态特性导致静态分析受限：
- 用
import module方式导入后通过module.func调用，rename不会追踪到该调用（Pylance 默认不启用此深度分析） - 变量名与内置名同名（如
list,str）时，重命名会被禁用（防破坏内置行为） - 未在工作区根目录放置
pyproject.toml或setup.py，Pylance 可能无法识别包结构，导致跨文件重命名失效 - 临时解决：选中符号 →
Ctrl+Shift+P→ 运行Python: Restart Language Server，再试F2
真正影响重构质量的，往往不是快捷键按得够不够快，而是语言服务有没有把整个项目当做一个连贯上下文来理解——配置缺失、文件未纳入索引、或用了不兼容的扩展，都会让 rename 退化成查找替换。动手前花 30 秒确认语言模式和 LSP 状态，比反复重试更省时间。