VSCode重构前看不到预览是因为文件未保存或语言服务器未就绪：必须先保存文件（Ctrl+S），确保tsconfig.json/pyrightconfig.json等配置存在且状态栏显示正确语言模式，否则LSP无法完成语义分析，预览功能失效。
重构前为什么看不到预览？
VSCode 的重构操作（比如重命名、提取函数）默认不弹出完整预览窗口，而是直接执行或只在编辑器内高亮变更位置。预览功能需要满足两个前提：文件已保存 + 语言服务器完成语义分析。未保存的文件通常只触发语法级检查，LSP 不会返回跨文件引用，也就无法生成安全预览。
常见现象包括：F2 重命名后直接改完没提示、Ctrl+. 唤出菜单但“Preview changes”选项灰掉、右键 Refactor 菜单里没有预览入口。
- 确保当前文件已保存（
Ctrl+S），特别是 TypeScript/Python 项目依赖tsconfig.json或pyrightconfig.json才能启用完整分析 - 检查状态栏右下角语言模式是否正确（如显示 “TypeScript” 而非 “Plain Text”）
- 打开命令面板（
Ctrl+Shift+P），输入Developer: Toggle Developer Tools，看 Console 是否报Language client is not ready类错误
F2 重命名后怎么看到所有改动位置？
F2 本身不打开预览面板，但它触发的重命名流程天然支持预览——你只需在输入新名称前，按 Shift+F12。这个组合键会立即列出所有引用位置，在侧边栏以树形结构展示，每项点击可跳转，是比弹窗更可控的“预览方式”。
注意：Shift+F12 查的是当前符号的全部引用，不是“即将修改的位置”，所以它必须在 F2 激活前使用；一旦你回车确认重命名，引用列表就失效了（因为符号名已变）。
- 若
Shift+F12无响应，大概率是语言服务器没加载成功，或当前文件类型不被支持（比如 .js 文件没开 JS 语言服务） - Python 需确认
python.languageServer设置为"Pylance"，且项目根目录有pyproject.toml或pyrightconfig.json - TypeScript 项目若无
tsconfig.json，Shift+F12只能查到当前文件内的引用
Ctrl+. 弹出菜单后如何强制触发预览？
Ctrl+.（Windows/Linux）唤出的是 Code Action 菜单，它本身不带预览，但部分重构项（如 “Rename symbol”、“Extract to function”）在选中后会自动进入预览流程——前提是上下文允许。例如：光标停在函数名上按 Ctrl+. → 选 “Rename symbol” → 输入新名时，编辑器顶部会显示黄色横幅：“Will rename 3 occurrences across 2 files”，点击它才展开详细预览。
这个横幅容易被忽略，尤其当它出现在多行代码中间时。它不是独立窗口，而是一个内联提示，点一下才会拉出可滚动的变更列表。
- 如果横幅不出现，说明语言服务器没返回足够引用信息，常见于未保存文件、JS 文件未开启
javascript.suggest.autoImports、或 Java 项目缺少Extension Pack for Java - Java 用户需确认已安装并启用
Language Support for Java，否则Ctrl+.根本不会列出任何重构项 - 该横幅只对“安全重构”生效，比如动态拼接的调用（
obj[methodName]）不会计入，也不会出现在预览中
变更真正生效的那一刻发生了什么？
VSCode 的重构不是文本替换，而是通过 LSP 的 textDocument/rename 或 textDocument/codeAction 请求，由语言服务器计算出所有语义等价位置，再批量下发编辑指令。这意味着：生效瞬间，所有匹配位置被原子更新，不存在“只改了一半”的中间态。
但这也带来一个关键约束：一旦你手动修改了某处引用（比如在重命名中途切出去改了另一个文件），语言服务器可能无法再保证一致性，后续操作会失败或跳过该位置。
- 不要在重构过程中切换标签页去手动改其他地方——哪怕只是加个空格
- Git 暂存区（staging area）里的未提交更改不影响重构，但工作区（working directory）里的未保存修改会影响 LSP 分析结果
- 如果重构后发现某处没更新，不是工具漏了，而是那处引用不在语言服务器的静态分析范围内（比如 eval、字符串拼接、反射调用）
Ctrl+S；而变更没全生效，常常是因为某处引用本就不在静态分析边界内。 
