重命名卡死主因是语言服务未加载：先检查右下角语言模式是否为javascript/typescript/python，确认状态栏有初始化提示；再查developer tools中renameprovider等报错；禁用javascript refactor插件；确保jsconfig.json/tsconfig.json在根目录且含include配置。
重命名卡死时先看右下角语言模式和状态栏提示
VS Code 重命名卡死，90% 不是插件问题，而是语言服务压根没加载成功。右下角显示 Plain Text 或 Auto-detect，就别急着查插件——它连当前文件是啥语言都不知道，renameSymbol 请求根本发不出去。
实操建议：
- 点击右下角语言标识，手动选为
JavaScript、TypeScript或Python（不是JavaScript React这类变体，除非你真用它） - 观察状态栏是否出现
Loading Pylance…、TypeScript initializing…或Starting JavaScript language features；没这些，说明 LSP 还在等配置或已崩溃 - 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，切到 Console 标签页，搜crashed、failed to start、renameProvider—— 报错源头往往在这里
禁用 JavaScript Refactor 插件再试 F2
JavaScript Refactor（micnic 开发的那款）虽能自动修 import 路径，但它和 VS Code 内置 TypeScript Server 在重命名流程中存在竞态：它会拦截 textDocument/rename 请求并尝试自己处理，结果常导致卡住、无响应或预览窗口空白。
实操建议：
- 在扩展面板里搜
JavaScript Refactor，禁用它（不是卸载） - 重启 VS Code 或执行
Developer: Restart Extension Host - 用
Ctrl+Click点击变量名，确认能跳转到定义；能跳 → 再按F2测试是否恢复响应 - 若必须用路径自动修复，等重命名完成后再启用该插件，单独触发
Update imports for moved file命令
检查 jsconfig.json / tsconfig.json 是否被忽略
即使项目根目录有 jsconfig.json，VS Code 也可能因工作区设置或多根工作区结构而“视而不见”。此时 renameSymbol 退化为纯文本替换，一卡就是几秒，且只改当前文件。
实操建议：
- 确认配置文件在**最外层工作区根目录**（不是子文件夹里），且文件名严格为
jsconfig.json或tsconfig.json（大小写敏感） - 配置至少含
{"include": ["**/*"]}，避免空配置或只写{}导致语言服务跳过索引 - 打开命令面板，运行
TypeScript: Open TS Server Log，搜索configFile关键字，看日志里加载的是不是你预期的那个路径 - 多根工作区下，检查
.code-workspace文件里"folders"的路径是否指向正确根目录；错一层，tsconfig.json就失效
Python 项目要关掉其他 Python 插件干扰
Pylance 是唯一被官方推荐用于 Python 重命名的 LSP 实现。但很多用户同时装了 Python（Microsoft 官方基础插件）、Pylance、Pyright、Auto Import，它们之间会抢 rename 处理权，导致卡顿或静默失败。
实操建议：
- 只保留
Pylance和Python（二者配套使用），禁用Pyright（它和 Pylance 功能重叠）、Auto Import（常劫持F2）、Import Cost（与 LSP 冲突） - 确保已通过
Python: Select Interpreter选中带pyproject.toml或setup.py的环境；否则 Pylance 默认只分析单文件 - 在
pyproject.toml中加[tool.pyright]块，哪怕只写extraPaths = ["src"]，也能显著提升跨文件引用识别率
Ctrl+Click 能跳转且状态栏显示引用数，这是唯一可靠的前置校验。
