企业官网建设流程全解析

• 开发工具

Spaceship Prompt 的swift区段用于在 Zsh 提示符中显示当前可用的 Swift 版本，帮助你快速确认 Xcode 工具链或 Swift 环境的版本信息。本文以 docs/uk/sections/swift.md 为核心骨架，结合 sections/swift.zsh 等仓库源码，完整讲解该区段的触发条件、版本解析逻辑、全部配置项，以及它与swiftenv区段在"本地/全局版本优先级"上的协作关系，读完后你可以精准定制自己的 Swift 环境提示。

区段概览：显示什么、什么时候显示

swift区段（对应 Zsh 函数spaceship_swift）的作用非常单一：显示当前 Swift 的版本号，渲染效果形如🐦 v6.0.3。它并不会无条件显示，而是需要同时满足两个前提条件：

1. 当前目录存在 Swift 项目特征文件。源码 sections/swift.zsh#L34 使用spaceship::upsearch -s "*.xcworkspace" "*.xcodeproj" "Package.swift"向上递归查找工作区文件（.xcworkspace）、工程文件（.xcodeproj）或 Swift Package 清单（Package.swift），只有命中其一才继续渲染。这意味着该区段天然"按项目上下文显示"，离开 Swift 项目后自动隐藏。
2. 系统中存在swift可执行文件。sections/swift.zsh#L36 通过spaceship::exists swift检查命令是否在PATH中，未安装则直接返回。

需要特别说明的是：默认情况下该区段是异步渲染的（!!! important提示），由SPACESHIP_SWIFT_ASYNC控制，避免版本探测拖慢提示符的响应速度。

版本号是如何解析出来的

区段通过执行swift --version并从输出首行提取版本号，核心代码在 sections/swift.zsh#L38：

local swift_version=$(swift --version 2>/dev/null | head -n 1 | sed -En 's/^.*Apple Swift version (([[:digit:]]+\.)*[[:digit:]]+).*$/\1/ip')

解析链路拆解如下：

• swift --version 2>/dev/null：获取 Swift 工具链版本信息，错误输出被丢弃；
• head -n 1：只取第一行（典型的输出形如Apple Swift version 6.0.3 (swift-6.0.3-RELEASE)）；
• sed -En 's/^.*Apple Swift version (([[:digit:]]+\.)*[[:digit:]]+).*$/\1/ip'：用扩展正则捕获Apple Swift version之后、以点和数字组成的版本号（如6.0.3），-E开启扩展正则，-n配合p只打印匹配行，i忽略大小写；
• 若提取结果为空（例如非 Apple 发行版 Swift 的输出格式不同），sections/swift.zsh#L40 会直接return，保证区段不会显示残缺内容。

最终通过spaceship::section::v4以--prefix/--suffix/--symbol/--color组装渲染，正文统一加v前缀输出（sections/swift.zsh#L42-L47）。

配置项完整说明

区段全部配置项均以SPACESHIP_SWIFT_为前缀，默认值在 sections/swift.zsh#L13-L18 中定义。下表与 docs/uk/sections/swift.md 保持一致并补充了默认值语义：

已废弃参数：SHOW_LOCAL / SHOW_GLOBAL 与 swiftenv 的迁移

仓库源码中保留了向后兼容逻辑。在 sections/swift.zsh#L24-L25 中：

spaceship::deprecated SPACESHIP_SWIFT_SHOW_LOCAL "Use %BSPACESHIP_SWIFTENV_SHOW_LOCAL%b instead" spaceship::deprecated SPACESHIP_SWIFT_SHOW_GLOBAL "Use %BSPACESHIP_SWIFTENV_SHOW_GLOBAL%b instead"

也就是说，旧文档中"本地版本优先于全局版本"的语义，如今已由独立的swiftenv区段承担（见 docs/sections/swiftenv.md 与 sections/swiftenv.zsh）。如果你仍在使用SPACESHIP_SWIFT_SHOW_LOCAL/SPACESHIP_SWIFT_SHOW_GLOBAL，Spaceship 会打印弃用提示，请改用：

• SPACESHIP_SWIFTENV_SHOW_LOCAL（默认true）：基于swiftenv的当前本地版本；
• SPACESHIP_SWIFTENV_SHOW_GLOBAL（默认false）：基于swiftenv的全局版本。

从 sections/swiftenv.zsh#L29-L35 的实现可以看到优先级逻辑：当SHOW_GLOBAL为true时直接输出swiftenv version的版本号；否则在SHOW_LOCAL为true且存在.swift-version文件（即项目级版本锁定）时才输出本地版本——这正体现了本地版本优先于全局版本的设计：只要项目目录里存在.swift-version，就显示项目锁定的 Swift 版本。

实战：自定义 Swift 区段样式

你可以在~/.zshrc中（或 Spaceship 配置文件 里）覆盖任意配置项。例如：

# 关闭异步渲染（在极慢的机器上可接受一点延迟换取确定性输出） SPACESHIP_SWIFT_ASYNC=false # 自定义符号与颜色 SPACESHIP_SWIFT_SYMBOL="🦅·" SPACESHIP_SWIFT_COLOR="cyan" # 自定义前后缀 SPACESHIP_SWIFT_PREFIX="[" SPACESHIP_SWIFT_SUFFIX="] "

其中SPACESHIP_SWIFT_SYMBOL的默认值🐦在源码中通过BIRD=$'\xF0\x9F\x90\xA6'定义（sections/swift.zsh#L7），即 UTF-8 编码的鸟形 emoji。如果你在使用swiftenv管理多版本 Swift，还可同步定制SPACESHIP_SWIFTENV_*系列参数，让两处风格保持一致。

相关源码与文档索引

• 区段实现：sections/swift.zsh
• 区段文档（英文原版）：docs/sections/swift.md
• 区段文档（乌克兰语）：docs/uk/sections/swift.md
• swiftenv区段实现：sections/swiftenv.zsh
• swiftenv区段文档：docs/sections/swiftenv.md
• 异步渲染机制说明：docs/sections/async.md
• 如何加载自定义区段：docs/config/loading-sections.md

小结

swift区段是一个典型的"按需显示 + 命令探测"型提示符组件：通过向上查找 Swift 项目特征文件决定是否展示，通过解析swift --version输出提取版本号，并提供完整的前缀、后缀、符号、颜色与异步渲染开关。对于使用swiftenv管理多版本 Swift 的开发者，建议将本地/全局版本显示迁移至swiftenv区段，即可获得"本地优先于全局"的版本提示能力。

• 开发工具