Swift Academy · 课时

Swift 脚本（swift shebang）与命令行工具

使用 shebang 创建可运行的 Swift 脚本，读取 CommandLine.arguments ，输出帮助信息，并以正确的状态码退出。

第 1 / 3 课8 个步骤

Swift 脚本（swift shebang）与命令行工具 是 CoddyKit 上的免费 Swift Academy 课时。这是第 1 节课，共 3 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Swift Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Swift Academy 课程共包含 3 节课。

为什么使用 Swift 脚本？

Swift 可以充当脚本语言。使用解释器指令直接运行文件，解析 CommandLine.arguments，并通过状态码退出以实现自动化。

解释器指令基础

将 #!/usr/bin/env swift 添加为第一行，使文件具有可执行权限，然后像运行命令行脚本一样运行它。

// First line (shebang) when saved to a file:
// #!/usr/bin/env swift
// Then mark file executable: chmod +x tool.swift
// Run directly: ./tool.swift

print("Hello from a Swift script!")

参数解析

使用 CommandLine.arguments 读取输入。缺少必需参数时，请提供简短的用法提示。

// Parse arguments: CommandLine.arguments[0] is the script path.
let args = CommandLine.arguments.dropFirst()  // ignore script name
if args.isEmpty {
    print("Usage: greet.swift <name>")
} else {
    let name = args[args.startIndex]
    print("Hello, \\(name)!")
}

简单选项

无需依赖项即可实现简单标志。让帮助信息清晰明了：--help、--times N、--shout。

// Very small options parser: --shout and --times
struct Options {
    var shout = false
    var times = 1
    var rest: [String] = []
}

func parse(_ raw: ArraySlice<String>) -> Options {
    var o = Options()
    var it = raw.makeIterator()
    while let token = it.next() {
        switch token {
        case "--help", "-h":
            print("Usage: echo.swift [--shout] [--times N] <text>")
            exit(0)
        case "--shout":
            o.shout = true
        case "--times":
            if let nStr = it.next(), let n = Int(nStr), n > 0 { o.times = n }
        default:
            o.rest.append(token)
        }
    }
    return o
}

let options = parse(CommandLine.arguments.dropFirst())
let text = options.rest.joined(separator: " ").isEmpty ? "echo" : options.rest.joined(separator: " ")
let output = options.shout ? text.uppercased() : text
for _ in 0..<options.times { print(output) }

退出状态

成功时使用 exit(0)，失败时使用非零状态码。将错误打印到 stderr，以便用于命令行流水线。

import Foundation

enum CLIError: Error { case invalidInput }

func validateNumber(_ s: String) throws -> Int {
    guard let n = Int(s) else { throw CLIError.invalidInput }
    return n
}

let args2 = CommandLine.arguments.dropFirst()
do {
    guard let first = args2.first else {
        print("Usage: num.swift <int>"); exit(64) // EX_USAGE
    }
    let n = try validateNumber(first)
    print("ok:", n)
    exit(0)
} catch {
    fputs("error: \\(error)\\n", stderr)
    exit(1)
}

编译与分发

要进行分发，请使用 swiftc 编译以生成二进制文件。对于更大型的命令行工具，请迁移到 SwiftPM 和 swift run。

// You can compile a single-file tool:
// swiftc tool.swift -o tool
// ./tool --help
print("Tip: use swiftc to build a tiny binary; for multi-file CLIs prefer SwiftPM (swift package init).")

解释器指令的作用

快速检查：解释器指令可以实现什么？

在交互式课程中回答

回顾

回顾：添加解释器指令，读取 CommandLine.arguments，打印用法信息，并使用正确的状态码退出。使用 swiftc 编译，或迁移到 SwiftPM 来构建更大的工具。

免费开始

用 AI 导师学习 Swift — 免费

在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。

课程: 122
课程: 409

免费开始学习查看完整课程

常见问题解答

「Swift 脚本（swift shebang）与命令行工具」课时是免费的吗？

是的 — 「Swift 脚本（swift shebang）与命令行工具」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Swift Academy 课程的其余内容，请升级到 CoddyKit PRO。 Swift Academy 课程共包含 3 节课。

「Swift 脚本（swift shebang）与命令行工具」这节课中我会学到什么？

使用 shebang 创建可运行的 Swift 脚本，读取 CommandLine.arguments ，输出帮助信息，并以正确的状态码退出。你通过在浏览器中直接运行的动手代码来练习 Swift Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Swift Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Swift Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 1 节课，共 3 节。

「Swift 脚本（swift shebang）与命令行工具」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Swift Academy 课中编写并运行代码吗？

能。每节 Swift Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Swift Academy