Cmd + P 不能跳转 Swift 符号，因其仅搜索文件名；应使用 Cmd + Shift + O 跳转符号，但需项目含 Package.swift、安装官方 Swift 扩展且状态栏显示“Swift (LSP)”。
Cmd + P 不能跳转到Swift符号？先确认项目结构
VSCode 的 Cmd + P 默认只搜文件名，对 Swift 符号（比如函数、struct）无效。真正起作用的是 Cmd + Shift + O，但它依赖 Swift 插件正确加载 SourceKit-LSP。
常见错误现象：按下 Cmd + Shift + O 后弹出空列表，或提示 “No symbols found”。这通常不是快捷键问题，而是插件未就绪：
- 项目根目录下必须存在有效的
Package.swift（哪怕只是空模板），否则插件不启动语言服务器 - 确保已安装官方
Swift for Visual Studio Code扩展（非第三方“Swift Syntax”等轻量插件） - 底部状态栏右下角应显示 “Swift (LSP)” 绿色图标；若为灰色或报错，说明工具链未识别，需检查
swift --version是否可用
Cmd + Click 跳转定义失败？注意光标位置和泛型边界
Swift 中 Cmd + Click 跳转定义在多数场景有效，但有明确限制：
- 光标必须完全落在标识符内部（如
MyView的任意字母上），不能停在点号.或括号()上 - 泛型类型别名（如
typealias Handler = (Int) -> Void）点击别名本身不会跳转，需点进右侧具体类型 - 协议扩展中的默认实现，
Cmd + Click会跳转到协议声明而非扩展体；想看实现要手动打开对应 extension 文件 - 如果跳转后空白，大概率是 SourceKit-LSP 正在解析中——等待几秒再试，或执行命令面板中的
Developer: Restart Language Server
调试时 F9 断点不生效？检查 launch.json 的 program 字段
Swift 插件使用 LLDB DAP 调试，F9 设置断点本身没问题，但断点不命中常因配置偏差：
-
launch.json中的program必须指向可执行文件路径，例如"${workspaceFolder}/.build/debug/MyApp"，而非源码路径或.swift文件 - 确保构建目标已成功编译：终端运行
swift build -c debug后再启动调试，否则.build/debug/目录可能为空 - 断点打在异步闭包（如
Task { ... }内部）时，需确认调试器支持 Swift Concurrency —— 当前插件要求 Swift 5.9+ 工具链，旧版本会忽略此类断点 - 修改代码后未重新构建就按
F5，断点仍绑定旧二进制，务必先Cmd + Shift + B触发构建任务
Cmd + K Cmd + F 格式化 Swift 代码没反应？格式化引擎未启用
Cmd + K Cmd + F 是 VSCode 原生格式化快捷键，但 Swift 插件默认不接管该操作，除非显式配置：
- 打开设置（
Cmd + ,），搜索editor.defaultFormatter，将 Swift 文件的默认格式化工具设为sswift.vscode-swift - 确认项目中存在
.swift-format配置文件（推荐），否则插件使用内置规则，可能与团队规范不一致 - 若仍无响应，检查命令面板（
Cmd + Shift + P）中是否能搜到Swift: Format Document—— 搜不到说明插件未激活，重启 VSCode 或重装扩展 - 注意：格式化对
async/await语法的支持依赖 Swift 工具链版本，5.7 以下可能跳过部分新语法节点
Swift 开发者最容易忽略的其实是状态栏提示：每次打开 .swift 文件，右下角是否显示 “Swift (LSP)” 和当前工具链版本。没这个，所有快捷键都只是摆设。
