VS Code 依赖语言服务器（LSP）和对应扩展实现可靠重命名：Python 需 ms-python.python + Pyright 并确保项目结构可索引；TS/JS 用 tsserver，需禁用 autoImports 并光标置于声明处；Java/C# 需官方扩展且必须打开完整工程根目录；所有语言重命名生效前提均为 LSP 完成全项目语义分析。
VS Code 本身不内置完整的代码重构引擎，但通过语言服务器（LSP）和扩展支持，能实现可靠的重命名与基础重构——关键在于选对扩展、配对语言服务、并理解哪些操作是安全的。
Python 项目重命名变量必须装 python 扩展 + 启用 pylsp 或 pyright
默认的 Python 扩展（Microsoft 官方）依赖 pyright 提供语义重命名。若重命名后只改了当前文件、没更新导入处或引用处，大概率是 pyright 没启用或没正确解析项目结构。
- 确保已安装
ms-python.python扩展，并在设置中开启python.languageServer→ 选Pyright - 项目根目录下有
pyproject.toml或setup.py时，pyright才能跨文件索引；否则重命名仅作用于单文件 - 右键变量 →
Rename Symbol（快捷键F2），输入新名后按Enter，它会高亮所有可安全替换的位置——不是所有高亮都该改，比如字符串里的同名文本不会被包含，这是正常行为
JavaScript/TypeScript 重命名依赖 tsserver，禁用 javascript.suggest.autoImports 可避免干扰
TypeScript 自带的语言服务（tsserver）开箱即用，但自动导入建议有时会在重命名过程中插入无关 import 行，导致重命名结果异常。
- 检查设置中
javascript.suggest.autoImports和typescript.suggest.autoImports是否为false - 重命名前确认光标停在变量声明处（如
const foo = 1;的foo），而非调用处；否则可能触发“局部重命名”而非“全局符号重命名” - 若重命名后出现
Cannot find name 'xxx'错误，通常是类型定义未加载，尝试重启 TS 服务器：命令面板 →Developer: Restart TS Server
Java / C# 等强类型语言需额外安装对应语言扩展，且项目必须可构建
Java 需要 redhat.java + vscode-java-dependency，C# 需要 ms-dotnettools.csharp。它们的重命名能力高度依赖项目能否被正确加载为工程（例如 Maven / .NET SDK 能识别 pom.xml 或 .csproj）。
- Java 项目若打开的是单个
.java文件而非整个文件夹，重命名将不可用——必须用 VS Code 打开含pom.xml的根目录 - C# 中重命名类名时，
.cs文件名不会自动同步；这是设计使然，VS Code 不处理文件系统级操作 - 重命名接口方法时，实现类中的 override 方法会被自动更新，但抽象类子类是否更新取决于 LSP 实现完整性，别完全依赖
/**
* 示例：TypeScript 中 F2 重命名 user → currentUser
* 以下三处会被同时修改（前提是 tsserver 已索引完整）
*/
const user = { name: 'Alice' };
console.log(user.name);
function greet(u: typeof user) { return u.name; }
重命名真正可靠的前提，是语言服务器完成了全项目语义分析。没看到“正在索引…”提示，或者状态栏左下角没有对应语言图标，就别指望跨文件重命名能生效。这不是配置问题，是工程还没“活”起来。
