VSCode 支持跨文件语义级重命名：1. 按 F2 重命名符号，自动更新所有引用；2. 用 Cmd+Shift+ P 调用 Rename Symbol 预览修改范围；3. 配置 tsconfig.json/jsconfig.json 启用完整语义分析；4. Python 需安装 Pylance 扩展以支持准确跨文件重命名。
如果您在 VSCode 中对一个函数、变量或类名进行重命名，但希望该修改能自动同步到所有引用它的文件中，同时避免意外修改无关标识符，则需要依赖编辑器的语义级重命名能力。以下是实现跨文件安全重构的具体操作方式：
本文运行环境：MacBook Air M2，macOS Sequoia。
一、使用 F2 快捷键触发语义重命名
VSCode 内置的 TypeScript、JavaScript、Python、Java 等语言扩展支持基于语言服务的智能重命名，它会分析符号定义与引用关系，仅修改作用域内有效引用，跳过字符串、注释及非标识符匹配内容。
1、将光标置于需重命名的符号（如函数名calculateTotal）上。
2、按下 F2 键，此时符号被高亮并进入重命名输入框。
3、输入新名称（如computeSum），按回车确认。
4、VSCode 立即在当前工作区所有相关文件中更新该符号的所有引用，并保持导入路径、作用域层级和类型声明一致性。
二、启用 Rename Symbol 命令面板调用
当快捷键不可用或需确认重命名范围时，可通过命令面板显式调用重命名功能，确保操作前获得引用位置预览，降低误操作风险。
1、按下Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux）打开命令面板。
2、输入并选择 Rename Symbol 命令。
3、在弹出的输入框中键入新名称。
4、VSCode 在底部状态栏显示即将修改的引用数量，并在编辑器右侧预览所有待更新位置。
三、配置 JavaScript/TypeScript 语言服务器增强识别精度
默认情况下，JS/TS 语言服务可能因未启用检查或缺少 jsconfig.json/tsconfig.json 而降级为文本匹配。启用完整语义分析可确保跨文件导出 / 导入链被准确追踪。
1、在项目根目录创建tsconfig.json（TypeScript）或jsconfig.json（JavaScript）。
2、确保配置中包含 “compilerOptions”: {“allowSyntheticDefaultImports”: true, “moduleResolution”: “node” } 等关键项。
3、重启 VSCode 窗口或执行 Developer: Restart TS Server 命令。
4、再次执行 F2 重命名，此时对export default、命名空间导入、类型别名等复杂场景的支持显著提升。
四、安装 Python 扩展启用 Pylance 重命名支持
Python 原生语法不提供编译期符号表，但 Pylance 语言服务器通过静态分析构建引用图，使重命名具备跨文件准确性，尤其适用于模块级函数与类属性。
1、在 VSCode 扩展市场中搜索并安装Pylance（由 Microsoft 官方维护）。
2、打开任意 .py 文件，右键点击目标符号，选择 Rename Symbol 上下文菜单项。
3、输入新名称后，Pylance 自动识别 from module import name、import module 及module.name三种引用形式，并分别更新导入语句与调用点。
4、若符号被标记为 @property 或位于 __all__ 列表中，重命名操作将同步修正对应模块公开接口声明。
