F2重命名必须光标精准落在声明符号起始处，依赖LSP语义分析而非文本替换；需确保语言服务就绪、配置正确、导入导出方式匹配，并通过预览窗口核对所有变更。
光标必须落在声明符号起始位置才能触发语义重命名
VSCode 的 F2 重命名不是字符串查找替换，它依赖语言服务器（LSP）定位符号定义。光标停在 getUserById 中间、末尾空格后、或紧邻点号（如 user.name 的 name）时，大概率只改局部访问，甚至报 “No result”。
正确操作路径：
– 用 Ctrl+←（Windows/Linux）或 Option+←（macOS）逐词跳转，直到光标卡在标识符最左侧
– 或鼠标双击变量/函数名，确保高亮范围**严丝合缝覆盖整个名字**，不多也不少（比如选中 fetchUser 而非 fetchUser() 或 fetchUser 后的空格）
– 若是对象字面量里的 key（如 { name: 'a' }），需手动选中 name: 这部分再按 F2，否则只改 obj.name 访问不改 key 定义
跨文件重命名前必须确认语言服务已就绪
右下角状态栏显示 “TypeScript initializing…” 或 “Python loading…” 时，按 F2 会失败或漏改——这不是操作问题，是 LSP 尚未完成符号索引。
检查与准备步骤：
– 点击右下角语言模式（如显示 “Plain Text”），手动切换为对应语言（如 “TypeScript”）
– TypeScript/JS 项目：根目录必须存在有效的 tsconfig.json 或 jsconfig.json，且相关文件在 include 范围内
– Python 项目：必须安装 Pylance（非基础 Python 扩展），并确保工作区根有 pyproject.toml 或 setup.py
– 按 Ctrl+Click（macOS 为 Cmd+Click）测试能否跳转到定义；跳转失败 = 重命名必然漏改
导出符号重命名需匹配导入方式
改一个 export function apiRequest()，结果调用处 utils.apiRequest() 没变？问题出在模块系统和导入写法上。
关键约束：
– 导出必须是具名导出（export function apiRequest）或默认导出带名字（export default function apiRequest），避免 module.exports = { apiRequest } 这类 CommonJS 混用
– 调用方必须用具名导入：import { apiRequest } from './api'；若用 import utils from './api' 再调 utils.apiRequest，LSP 无法建立符号链接，重命名不会触达
– TypeScript 中，若用 type 别名（如 type ApiFn = typeof apiRequest），默认不参与重命名，需开启配置 "typescript.preferences.renameShorthandProperties": true
预览窗口不是摆设，必须逐项核对
按 F2 输入新名后弹出的 “Preview changes” 窗口，是唯一能提前发现误改的地方。
重点关注：
– 是否混入了字符串字面量（如日志里写了 'calling apiRequest'，会被一起改）
– 是否遗漏了动态拼接场景（如 obj[methodName] 或 eval('apiRequest()')，这些永远不被识别）
– 是否包含测试文件、类型声明文件（.d.ts）等易被忽略的引用位置
– 若项目含多个子包或 monorepo，确认所有相关工作区文件夹都已加载为 VSCode 工作区根目录
重命名后第一件事：立刻运行单元测试 + 检查构建是否通过。语义重命名很准，但改的是“它认为的符号”，不是“你心里想的那个东西”。
