英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

Visual Studio Code 的 Swift

此扩展为 Visual Studio Code 添加了 Swift 语言支持，为在所有支持的平台上开发 Swift 应用程序提供无缝体验。它支持以下功能：

• 代码补全
• 跳转到定义、查看定义、查找所有引用和符号搜索
• 错误注释和修复建议
• 自动生成用于使用 LLDB DAP 调试的启动配置
• 自动任务创建
• 项目面板，可快速运行操作并查看依赖关系
• 测试资源管理器视图

注意
Visual Studio Code 的 Swift 扩展的大多数功能仅适用于使用 Swift 包管理器构建的项目。这些项目在其根文件夹中会有一个 Package.swift 文件。对 Xcode 项目（.xcodeproj）的支持有限。

创建新项目

构建和运行可执行文件

调试可执行文件

运行测试

文档

此扩展的 入门指南 和 官方文档 可在 swift.org 查阅。

该扩展使用 SourceKit LSP 作为 语言服务器，以提供代码补全功能。它还依赖于 LLDB DAP 扩展来启用调试功能。

如需提出新功能建议，可在 swift.org 论坛 的 VS Code Swift 扩展分类 发布帖子。如果遇到功能未按预期工作的问题，可以在 GitHub 仓库 提交问题。

扩展 API

Swift 扩展导出了一个全面的 API，可供其他 Visual Studio Code 扩展使用。该 API 提供对以下内容的访问：

• Swift 工具链：当前激活的 Swift 工具链，可在全局或每个项目中使用。
• Swift 项目：活动工作区中所有已知 Swift 项目的列表。
• SPM 包：Swift 包管理器的目标、产品、依赖项和插件。

该 API 包含一个版本号，遵循 语义化版本控制，并与扩展本身的版本号分开。有关何时增加此版本号的详细说明，请参见 贡献指南。

使用该 API

要在您的扩展中使用该 API，您可以从此存储库下载 src/SwiftExtensionApi.ts 文件，以获取适当的 TypeScript 类型定义。建议从标记发布版本下载，因为 main 分支不保证保持稳定。

示例用法：

import { getSwiftExtensionApi, SwiftExtensionApi } from './SwiftExtensionApi';

// Get the Swift extension API
const api: SwiftExtensionApi = await getSwiftExtensionApi();

// Access workspace context
const workspaceContext = api.workspaceContext;
if (workspaceContext) {
    // Get the toolchain version
    const toolchain = workspaceContext.globalToolchain;
    console.log(`Using Swift ${toolchain.swiftVersion}`);

    // Listen for folder changes
    workspaceContext.onDidChangeFolders((event) => {
        console.log(`Folder operation: ${event.operation}`);
    });

    // Access the in focus folder and its Swift package
    const currentFolder = workspaceContext.currentFolder;
    if (currentFolder) {
        const swiftPackage = currentFolder.swiftPackage;
        const targets = await swiftPackage.targets;
        console.log(`Found ${targets.length} targets`);
    }
}

贡献

Visual Studio Code 的 Swift 扩展是基于最初由 Swift 服务器工作组 创建的扩展。它现在由 swiftlang 组织 维护，原始扩展已被弃用。欢迎贡献，包括代码、测试和文档。有关更多详情，请参阅 CONTRIBUTING.md。

为了明确我们对成员的期望，Swift 采用了 Contributor Covenant 中概述的行为准则。这份广泛认可的文件有效地概括了我们的价值观。欲了解更多信息，请参阅 行为准则。