Swift 擅长这些事

• 性能：编译成原生机器码，没有虚拟机也没有 JIT 预热，适合从命令行工具到实时音频的各种负载。
• 安全：可选值、值语义、默认的数组越界检查、严格的初始化规则，把大量运行时崩溃变成了编译期错误。
• 并发：async/await、actor、Sendable 都由编译器做检查，“数据竞争"在 Swift 6 里是编译错误而不是线上事故。
• 表达力：泛型、协议扩展、结果构建器、宏，让库作者能写出看起来像语言内置的 API（@ViewBuilder 就是靠这套东西做到的）。
• 互操作：与 C、C++、Objective-C 都能直接互调，也能被 Objective-C 与 Python 调用。🚧
• 一套语言，全平台：同一份代码从 watchOS 写到 Linux 服务端；SwiftPM 在 Apple 与 Linux 上都能用。

你可能会嫌它烦的地方

• 编译器慢：类型检查器遇上深层表达式会变慢，全量类型推断偶尔需要你主动写注解来"帮它一把"。
• Apple 优先：SwiftUI、Combine、大部分系统框架只在 Apple 平台可用；Linux 上只有 Swift Foundation 与少数服务端框架。🚧
• 版本分裂：Swift 语言版本、语言模式（5/6）、平台部署目标、工具链版本，是四件不同的事，混起来能绕晕人。
• ABI 与生态：包管理器生态比主流语言小得多，很多领域得自己写或用 C 库。
• 字符串不按字节走：String 的索引不是整数，刚上手会觉得处处别扭——但它是对的，见 03 类型与字符串。

macOS

• 想要完整生态（SwiftUI、App Store 开发）：从 App Store 装 Xcode。
• 只想要命令行工具链：xcode-select --install，或者用 swiftly 管理多套工具链。

Linux

• 从 swift.org/download 下载官方 tarball，或用发行版仓库。Ubuntu 上官方推荐用 swiftly。

Windows 🚧

• 官方支持仍在完善，Windows 版工具链可以从 swift.org 获取，但系统框架相关的能力有限。

1
2
3

$ swift --version
swift-driver version: 1.168.6 Apple Swift version 6.4 (swiftlang-6.4.0.34.1)
Target: arm64-apple-macosx26.0

三条建议，按重要性排序：

1. 别顺读。 卡住了去目录里点，解决问题就走。
2. 留意切换标签。 本速查表大量使用多标签对比同一种效果的几种写法，比如「完整写法 / 尾随闭包 / $0 简写」——这页最值钱的东西都藏在那里。
3. 把 ⚠️ 当正文读。 速查表的错误示例，往往比正确示例更省时间。

💭 已经出事了（崩溃、结果不对、编译莫名其妙不过）？别从头翻，直接去 16 血泪速查——那一章是按症状索引的，每条都写着"你会怎么写 / 实际发生什么 / 正确写法"。

💭 如果你想要系统学一遍而不是速查，隔壁的 Swift 基础部分 是按学习顺序写的教程；本目录负责在你忘了怎么写的时候救急。

1
2
3

// Sources/Hello/main.swift
// SwiftPM 会把 main.swift 当作程序的入口文件
print("Hello from SwiftPM")

1

$ swift run Hello

不想用 main.swift，也可以在任何文件里写 @main：

1
2
3
4
5
6
7

// Sources/Hello/Hello.swift
@main
struct Hello {
    static func main() {
        print("Hello from @main")
    }
}

⚠️ 用 swiftc 直接编单个文件时，这个文件会被当成"允许顶层代码的入口"，@main 反而报错。想单文件验证，加 -parse-as-library：

1
2
3

$ swiftc atmain.swift -o app
atmain.swift:1:1: error: 'main' attribute cannot be used in a module that contains top-level code
$ swiftc -parse-as-library atmain.swift -o app    # ✅

SwiftPM 里不用管这条，因为包里的文件本来就不是按"入口脚本"编的。

App 的入口不是 main 函数，而是一个带 @main 的类型：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

import SwiftUI

@main
struct MyApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

UIKit 老写法里还有 @UIApplicationMain 和 application(_:didFinishLaunchingWithOptions:)，新项目基本不用了。🝖

1
2
3
4
5
6
7

// Sources/MyLib/Greeter.swift
public struct Greeter {
    public init() {}
    public func greet(_ name: String) -> String {
        "你好，\(name)！"
    }
}

库没有入口，只有 public 才能被外部看到。想看这一块的全部细节，去 13 工具链与工程。