VSCode 中 Swift 重构默认不生效，因其完全依赖 sourcekit-lsp 提供的语义分析，而 VSCode 不内置该服务；需确保 Package.swift 存在、sourcekit-lsp 正确启动并连接（Windows 必须通过 Remote-WSL），且快捷键绑定带上下文条件。
VSCode 里 Swift 重构命令为什么默认不生效？
因为 Swift 的重构能力完全依赖 sourcekit-lsp 提供的语义分析，而 VSCode 自身不内置该服务。你看到的“重命名”“提取函数”等选项，实际是 sourcekit-lsp 返回的 code action —— 如果它没启动、路径错、或没识别到 Package.swift，editor.action.refactor 就会静默失败，连灯泡图标都不显示。
- 确保项目根目录存在
Package.swift（哪怕只是空文件，只要能被 SPM 解析） - 检查 VSCode 底部状态栏是否显示 “Swift (SourceKit-LSP)” 或 “WSL: Ubuntu”，没出现说明语言服务器未连接
- Windows 原生环境必然失败；必须通过 Remote - WSL 打开项目，且
sourcekit-lsp路径要指向 WSL 内的二进制（例如/opt/swift/usr/bin/sourcekit-lsp）
如何给 Swift 重构绑定快捷键？
直接复用通用命令 editor.action.refactor 即可，但需加 when 条件过滤无效上下文，否则在纯文本文件里按了也没反应：
- 打开命令面板
Ctrl+Shift+P，输入 “Preferences: Open Keyboard Shortcuts (JSON)” - 添加如下条目：
{ "key": "ctrl+shift+r", "command": "editor.action.refactor", "when": "editorTextFocus && editorHasCodeActionsProvider && !editorReadonly" } - 不要用
editor.action.rename替代：它只做符号重命名，不触发提取变量/内联函数等完整重构菜单
哪些 Swift 重构操作实际可用？
不是所有 IDE 里的重构都支持。当前（2026 年中）VSCode + sourcekit-lsp 实际可用的有：
-
Extract to constant（选中字面量后触发） -
Extract to function（选中多行表达式，且能推导出明确返回类型） -
Rename symbol（光标停在标识符上按F2，比快捷键更可靠） -
Convert to property wrapper（仅对符合语法的变量声明有效）
注意：Move to file、Generate member 这类操作目前仍不可用，别在菜单里白找。
为什么快捷键有时弹不出菜单？
常见原因不是快捷键设错了，而是当前光标位置不满足 language server 的上下文判断：
- 光标在字符串字面量、注释或空行里 → 无可用 action
- 文件未被识别为 Swift（扩展名不是
.swift，或没打开在 WSL 工作区） -
sourcekit-lsp正在加载或崩溃（看输出面板里 “Swift” 频道是否有Failed to launch SourceKit-LSP） - 项目依赖未解析完成（
.build/debug目录为空时，部分重构会禁用）
真正稳定的触发方式：先选中一段代码（比如一个表达式），再按快捷键 —— 这比把光标停在变量名上更不容易失败。
重构依赖的是实时语义分析，不是文本匹配。工具链路径、WSL 环境、Package.swift 存在与否，三者缺一不可。漏掉任意一个，快捷键就只剩个空响。
