VSCode重命名功能要求光标必须位于符号的有效字符内（如变量名字母上），依赖语言服务器实现语义重命名，跨文件需TS项目正确配置，批量重命名需正则替换，重命名后需同步更新导出和类型声明。
重命名符号时光标必须落在符号内部
VSCode 的 rename symbol 功能（默认快捷键 F2）只在光标位于变量名、函数名、类名等可识别符号的**有效字符范围内**才激活。如果光标停在空格、括号后、点号后或引号内，F2 会无响应或报错“无法在此位置重命名”。
常见误操作包括：光标停在 myFunction() 的右括号上、obj.→ 的点号后、"myVar" 的引号内——这些位置都不触发重命名。
- 正确做法：把光标放在
myVar的任意一个字母上（如m、y或V），再按F2 - 对 import 名称重命名，需点在导入语句中的**绑定名**上，例如
import { <strong>useState</strong> } from 'react'→ 光标落在useState内部 - TypeScript 中类型别名（
type MyType = ...）和接口（interface MyInterface）同样支持，但光标必须落在MyType或MyInterface字符上
重命名范围取决于语言服务和文件上下文
VSCode 本身不解析代码，它依赖当前打开文件所启用的语言服务器（LSP）来判断哪些引用属于同一符号。这意味着：
- JavaScript/TypeScript 文件中重命名
const foo = 1，默认仅重命名当前文件内的所有foo引用（除非启用了"javascript.preferences.renameShorthandProperties": true等配置） - TS 项目中若
tsconfig.json配置了"composite": true且开启了"include"，跨文件重命名才更可靠；否则可能漏掉其他文件中的引用 - Python（Pylance）重命名
def my_func():时，若该函数被from module import *导入，调用处可能不会被识别为引用 - 未开启语法检查或语言服务器崩溃时，
F2可能只做简单文本替换（即“查找替换”模式），而非语义重命名 —— 此时 VSCode 底部状态栏会显示“正在重命名（文本）”而非“正在重命名（语义）”
批量重命名多个不同符号？得靠搜索替换+正则
VSCode 原生不支持一次选中多个非连续、不同名称的符号并统一重命名。比如想把 userID、userName、userEmail 同时改成 userId、userName、userEmail（修正大小写），不能靠单次 F2 完成。
这时需要手动组合使用：
- 打开搜索面板（
Ctrl+Shift+H/Cmd+Shift+H） - 勾选
.*（正则模式）和Aa（区分大小写） - 输入正则：
\b(user)(ID|Email)\b，替换为：$1$2→ 这能统一修复大小写，但不会自动推导语义关联 - 对函数调用链做批量调整（如把所有
get_user_data()改成fetchUserData()），建议先用Ctrl+Click跳转确认所有调用点，再用搜索替换，避免遗漏
注意：正则替换不校验作用域，可能误改字符串字面量或注释里的内容，务必开启 in selection 或先用 Ctrl+F 预览匹配项。
重命名后编译报错？检查类型声明和导出一致性
尤其在 TypeScript 中，重命名后出现 Cannot find name 'xxx' 或 Module has no exported member 'yyy'，大概率不是重命名失败，而是语言服务没及时更新缓存或导出路径断开。
- 检查
export语句是否同步修改：重命名function doSomething()后，若原为export { doSomething }，需确保重命名后的名字也在 export 列表中 - 重启 TS 服务器：按下
Ctrl+Shift+P（或Cmd+Shift+P），输入并执行Typescript: Restart TS server - 确认
declare module或global.d.ts中没有硬编码旧名称的类型声明 —— 这些不会被自动重命名 - Vue SFC 中的
<script setup></script>里定义的ref或computed，重命名后模板中{{ oldName }}不会自动更新，需手动处理
最易忽略的是：重命名发生在未保存的文件中，而其他已保存文件仍引用旧名，此时类型检查器会因缓存滞后给出错误提示，实际保存全部文件后常自动恢复。
