重命名卡住但没报错，首要排查插件冲突、终端占用和语言服务配置。插件可能静默覆盖rename命令；vscode终端中运行的监听进程会锁死目录导致f2卡顿；jsconfig.json/tsconfig.json缺失则跨文件重命名降级为仅当前文件。
重命名卡住但没报错？先查插件是否抢注 rename 命令
VSCode 的 editor.action.rename 命令只能由一个插件注册成功，后加载的插件会静默覆盖前面的——如果你按 F2 没反应、右键菜单缺“Rename Symbol”，或重命名只改局部变量，大概率是插件冲突。打开 Ctrl+Shift+I → Console 标签页，搜索 Command 'editor.action.rename'，若看到类似 contributed command 'editor.action.rename' but it's already registered 的提示，说明有插件越权注册。
常见肇事插件包括：esbenp.prettier-vscode（旧版）、ms-python.python（禁用后仍可能抢先注册）、某些“JS增强”类插件。别急着全卸载，用官方二分法定位更准：运行 Developer: Start Extension Bisect，按提示反复“是/否”复现问题，3–4 轮就能锁定具体插件。
语言服务就绪但重命名仍慢？检查终端是否锁死文件系统
F2 重命名符号本身不慢，但如果你在资源管理器里对文件夹按 F2 卡在“正在处理”，那根本不是语言服务问题，而是操作系统级阻塞——目标路径被其他进程持有了句柄。VSCode 终端里运行的 npm run dev、nodemon、watch 等监听进程，会持续 hold 住整个父目录，导致 rename 系统调用一直等待。
解决方式极简：
- 按
Ctrl+Shift+P→ 运行Terminal: Kill All Terminals - 确认底部没有残留终端标签页
- 再选中文件夹按 F2，通常 0.5 秒内完成
重命名后引用漏改？别怪插件，先看语言服务识别范围
漏改 ≠ 插件问题，更多是语言服务无法静态分析某些写法。比如：
-
import * as utils from './utils'：若utils是 namespace，utils.calculateSum可能不被识别为可重命名引用 -
require('./utils')['calculateSum']()或obj['methodName']：字符串索引完全逃逸 AST 分析，任何 LSP 都不会碰 -
const mod = await import('./utils')：动态导入目前不被 TypeScript Server 追踪符号引用 - JSX 属性值（如
<button type="primary"></button>）不属于符号引用，F2 不处理
这类场景下，即使插件干净、语言服务正常，重命名也必然漏改——这是语义边界决定的，不是 bug，也不是配置能绕过的。
jsconfig.json / tsconfig.json 配置缺失会导致重命名“看起来像失效”
纯 JS 项目没 jsconfig.json，或 TS 项目缺 tsconfig.json，语言服务就无法推导模块边界和路径别名，跨文件引用识别直接降级为“仅当前文件”。哪怕你只改一个 export const foo = () => {}，其他文件里的 import { foo } from './x' 也不会更新。
最小可用配置只需：
{ "compilerOptions": { "baseUrl": ".", "paths": { "@/*": ["src/*"] } }, "include": ["src/**/*"] }
注意："baseUrl" 和 "paths" 必须成对出现才生效；"include" 要覆盖所有源码目录，否则语言服务压根不索引那些文件。
真正难排查的点不在插件本身，而在于插件冲突、终端占用、语言服务配置这三者交织时，错误现象高度相似——比如都表现为“按 F2 没反应”，但背后原因完全不同。动手前先分清你是在重命名符号，还是在重命名磁盘文件，这个前提错了，所有排查都会跑偏。
