VSCode插件更新后重构预览失效，根本原因是语言服务器（LSP）未成功加载或配置不匹配：状态栏显示错误语言模式、缺失jsconfig.json/tsconfig.json/pyproject.toml等配置文件、python.languageServer设置不当，或LSP初始化失败导致语义分析退化为语法级，无法生成跨文件引用和预览横幅。
VSCode 插件更新后重构预览失效，基本不是功能被删了，而是语言服务器（LSP）没加载成功或配置不匹配——预览依赖语义分析结果，而 LSP 一旦降级为“语法模式”，就只能返回空引用列表或灰掉 Preview changes 选项。
为什么 F2 / Ctrl+. 后看不到预览横幅？
预览横幅（比如 “Will rename 3 occurrences across 2 files”）只在 LSP 完成跨文件符号分析后才出现。插件更新后常见断点：
-
F2按下后直接改完、无输入框 → 语言服务未接管当前文件，状态栏显示 “JavaScript” 但实际是 “Plain Text” -
Ctrl+.菜单里 “Rename symbol” 可选，但选中后不弹横幅 → 符号定义未解析，常见于缺jsconfig.json或tsconfig.json - Shift+F12 查不到引用 → LSP 初始化失败，控制台（
Ctrl+Shift+P→Developer: Toggle Developer Tools）里有Pylance initialization failed或Language client is not ready
Python 项目预览失效：Pylance vs pylsp 切换踩坑
VSCode 更新后，旧版 Pylance 可能因 "engines.vscode" 版本声明不兼容被自动禁用；而新装的 pylsp 若没配对 rope 后端，也无法触发预览。关键动作：
- 检查设置中
python.languageServer值是否为Pylance（大小写敏感），不是pylsp或Default - 确认项目根目录存在
pyproject.toml或pyrightconfig.json（哪怕空文件）——缺它 Pylance 不启用跨文件索引 - 若已切
pylsp，必须用pip install python-lsp-server[rope]安装，仅python-lsp-server不带重构能力 - 重启 VSCode 窗口（不是重载），否则
pylsp进程不会重新绑定
TypeScript/JS 项目预览不全：路径别名和动态引用的硬限制
即使 LSP 就绪，预览仍可能漏改——这不是 bug，是设计边界。以下情况永远无法被自动覆盖：
-
import { foo } from '@utils'中的foo不会被重命名，除非jsconfig.json里配了"paths": { "@utils/*": ["src/utils/*"] } -
require('utils')[varName]、eval('x.' + name)、模板字符串里的变量名 → 静态分析天然不可达 -
export * from './x'转发模块中的符号，重命名原文件不会同步更新导出侧名称 - 预览窗口里列出的修改项可手动取消勾选——比如日志字段
console.log('user', user)中的user是字符串字面量，不该参与重构
最易被忽略的是：预览功能本身不校验运行时行为。你看到 “3 occurrences across 2 files” 并不意味它们都该被改——比如某个 data 是 API 返回字段名，改了会破坏 JSON Schema 兼容性。重构前得先看调用上下文，而不是只信预览列表。
