Shaula Blog

iOS OSAllocatedUnfairLock

Tue, 23 Jun 2026 22:46:47 +0800

iOS 并发编程的新选择：OSAllocatedUnfairLock

在 iOS 并发编程中，os_unfair_lock 以其出色的性能，自 iOS 10 起成为替代已废弃 OSSpinLock 的重要底层同步原语。然而，随着 Swift 语言与并发模型的演进，开发者在直接使用这一底层 C API 时，往往会遇到一些与 Swift 值语义、存储地址稳定性以及 API 易用性相关的问题。

iOS 异步操作重试机制

Tue, 23 Jun 2026 22:46:47 +0800

iOS 智能重试机制

网络请求、API 调用这种异步操作，失败其实是家常便饭。怎么处理失败、要不要自动重试、怎么重试才能既解决问题又不把服务器搞崩——这几乎是每个 iOS 开发者都会遇到的现实问题。

React Native iOS 编译链接错误排查 - libc++ 缺失

Tue, 23 Jun 2026 22:46:47 +0800

React Native iOS 编译链接错误排查：libc++ 缺失

在将 React Native 集成到现有 iOS 项目时，经常会遇到各种编译问题。本文记录了一个典型的链接错误排查过程：项目编译阶段正常通过，但在链接阶段大量 C++ 标准库符号未定义，导致 BUILD FAILED。通过对比一个能正常编译的参考项目，最终定位并修复了问题。

Swift 宏系统解析（二）：@freestanding(declaration)

Tue, 16 Jun 2026 22:27:28 +0800

Swift 宏系统解析（二）：@freestanding(declaration)

在上一篇文章中，我们了解了 @freestanding(expression) 表达式宏如何消除表达式层面的重复代码。而 @freestanding(declaration) 声明宏能力更强——它能生成完整的类型、函数、属性等声明，从结构层面解决批量代码的重复问题。

Swift 宏系统解析（一）：@freestanding (expression)

Tue, 16 Jun 2026 22:27:14 +0800

Swift 宏系统解析（一）：@freestanding (expression)

Swift 5.9 引入的宏系统为语言带来了编译期元编程能力。在三种宏类型中，@freestanding(expression) 是最基础也最常用的一种——它能以零运行时开销消除重复代码，同时保持完整的类型安全。

Objective-C 前向声明

Thu, 07 May 2026 22:19:48 +0800

Objective-C 前向声明: 不止是解决循环引用

很多人学 @class 只是为了解决那个“A 里套 B，B 里套 A”的循环引用报错。其实前向声明真正的能耐远不止这点——它更像一个“编译期防火墙”，用好了能让你从无尽的重新编译里解脱出来。咱们今天把它掰开揉碎，顺便把容易踩坑的地方和更多玩法都聊透。

Swift 6.1 Package Traits：让依赖管理更灵活

Wed, 15 Apr 2026 21:16:19 +0800

Swift 6.1 Package Traits：让依赖管理更灵活

Swift 6.1 引入的 Package Traits 为 Swift Package Manager 带来了更灵活的条件编译和可选依赖管理能力。

为什么需要它？

实际开发中经常遇到这些问题：

可插拔依赖：比如 Swift OpenAPI Generator 支持 URLSession、AsyncHTTPClient、Vapor 等多种传输层。为了不把全部依赖都打进二进制，往往要拆成多个仓库，维护和发现都麻烦。
平台差异：Apple 平台用 OSLog，服务器端用 swift-log，需要一种优雅的方式来处理这种差异。
实验性 API：想发布新功能但又不想承诺稳定 API，加下划线或特殊注解会影响代码补全，不够理想。

基本用法

在 Package.swift 中定义特性：

Swift - LRU 缓存

Sun, 22 Mar 2026 20:21:51 +0800

Swift - LRU 缓存

什么是 LRU 缓存？

LRU（Least Recently Used，最近最少使用）是一种缓存淘汰策略。当缓存满了，它会优先删除最久没被访问的数据，保留最近刚用过的。

iOS 跨平台代码中通过条件编译导入 UIKit 框架代码

Sun, 18 Jan 2026 23:52:13 +0800

iOS 跨平台代码中条件编译

在 iOS 开发中，跨平台代码的条件编译是构建通用框架和组件的常见需求。当你需要针对不同的 Apple 系统平台进行代码适配时，#if canImport(UIKit) && !os(watchOS) 和 #if os(iOS) 这两种条件编译写法各有适用场景。本文将深入解析它们的本质区别，并提供清晰的选用指南。

Swift 中的 @preconcurrency

Mon, 08 Dec 2025 21:28:47 +0800

Swift 中的 @preconcurrency

随着 Swift 并发模型的成熟，开发者在集成旧代码或第三方库时面临着一个挑战：如何在严格的并发检查下使用非并发安全的 API？@preconcurrency 属性包装器正是为解决这一问题而生。

iOS - VIPER 架构

Fri, 24 Oct 2025 20:19:54 +0800

iOS - VIPER 架构

iOS 中的 VIPER 架构是 Clean Architecture 的具体实现之一，强调职责分离和模块化设计，特别适合中大型项目。VIPER 的名称由五个核心组件的首字母组成，各个组件的职责明确，协作流程清晰。

SwiftUI 中的 ViewBuilder

Fri, 24 Oct 2025 20:19:54 +0800

SwiftUI 中的 ViewBuilder

在 SwiftUI 的声明式语法背后，有一个强大的功能在默默地工作，让我们的界面代码如此优雅简洁——这就是 ViewBuilder。作为 Swift 语言中Result Builder特性的一个具体实现，ViewBuilder 彻底改变了我们构建视图层次结构的方式。

iOS UIButtonConfiguration

Tue, 09 Sep 2025 22:38:35 +0800

iOS UIButtonConfiguration

UIButtonConfiguration 是 iOS 15+ 引入的 API，它将按钮的样式、状态管理与内容组织提升到了全新高度。

为何需要 UIButtonConfiguration？

传统 UIButton 配置痛点(繁琐且易出错)：

iOS 后台任务革新 - BGTaskScheduler

Mon, 25 Aug 2025 23:01:34 +0800

iOS 后台任务革新: BGTaskScheduler

在 iOS 13 之前，后台任务执行一直是个难题——开发者需要小心翼翼地在系统限制下工作，而用户则常常为电池续航担忧。苹果推出的 BGTaskScheduler 框架彻底改变了这一局面，它提供了一套系统友好、高度节能的后台任务调度机制，让应用能在后台智能执行关键任务，同时最大限度减少对设备性能和电池的影响。

Swift DFS 与 BFS 算法

Mon, 25 Aug 2025 23:01:34 +0800

Swift 中的 DFS 与 BFS 算法

最近在开发过程中需要实现树形结构的选中状态联动（包括全选、部分选和未选状态），这里使用到了树的遍历算法。深度优先搜索（DFS）和广度优先搜索（BFS）是两种常用的图/树遍历算法，它们的主要区别在于访问节点的顺序：

iOS 动态方法调用 - NSInvocation

Tue, 29 Jul 2025 21:36:47 +0800

iOS 动态方法调用 - NSInvocation

NSInvocation 是 iOS/macOS 开发中 Objective-C 运行时的一个核心类，它用于封装并动态调用方法。该类允许将方法调用（包括目标对象、方法选择器、参数和返回值）存储为一个对象，从而实现延迟执行或跨上下文传递。

iOS UIAction

Thu, 10 Jul 2025 21:42:33 +0800

iOS UIAction

在上一篇文章我们介绍了如何使用 UIButtonConfiguration 对按钮的样式与状态进行管理，这篇文章介绍下可以同 UIButtonConfiguration 结合使用的一个类：UIAction.

什么是 `UIAction`？

UIAction 是在 iOS 14 中引入的一个类，它封装了一个动作（action）以及该动作的相关属性（例如标题、图像、属性等）。你可以把它看作是一个将动作（闭包）和按钮的某些属性（如标题、图像）打包在一起的对象。它在 UIButton(configuration:primaryAction:) 初始化方法中作为参数，用于定义按钮的主要点击行为。

Swift RegexBuilder

Tue, 10 Jun 2025 00:05:59 +0800

Swift RegexBuilder

在 Swift 5.7 中，苹果引入了全新的 RegexBuilder 框架，彻底改变了开发者处理正则表达式的范式。告别晦涩难懂的正则符号，拥抱类型安全、模块化且可读性强的 DSL（领域特定语言），本文将带你探索 RegexBuilder 的强大能力。

Swift Actor隔离机制详解

Wed, 28 May 2025 22:39:13 +0800

Swift Actor隔离机制详解

在 Swift 中，Actor 的 actor-isolated 机制是用于确保并发安全的核心理念。以下是对你引用的那段话的分步解释：

1. Actor 的默认隔离规则

所有声明默认是 actor-isolated：当你在一个 Actor 类型内部声明属性或实例方法时，它们默认会被标记为 actor-isolated（即“隔离到该 Actor 实例”）。
目的：这种隔离保证了同一时间只能有一个任务（Task）访问这些属性和方法，从而避免数据竞争（Data Race）。

actor BankAccount {
    var balance: Double = 0.0  // actor-isolated 属性
    
    func deposit(amount: Double) { // actor-isolated 方法
        balance += amount
    }
}

2. 同一 Actor 内部的自由访问

隔离环境内的自由调用：在 Actor 隔离的上下文（如 Actor 的方法内部）中，你可以直接访问同一 Actor 的其他 actor-isolated 声明，无需额外同步。

extension BankAccount {
    func withdraw(amount: Double) {
        // 可以直接访问 balance 和 deposit，因为它们在同一个隔离域
        if balance >= amount {
            deposit(amount: -amount) // 无需 await
        }
    }
}

3. 外部代码的异步访问

非隔离代码的访问限制：如果代码不在 Actor 的隔离环境中（例如普通函数、其他 Actor 的方法或非隔离方法），则必须通过 await 异步访问 actor-isolated 声明。

func externalTransfer(from account: BankAccount, to anotherAccount: BankAccount) async {
    // 必须用 await 调用 actor-isolated 方法
    await account.deposit(amount: 100.0)
    // 必须用 await 读取 actor-isolated 属性
    let balance = await account.balance
}

4. 非隔离声明 (`nonisolated`) 的特殊性

标记为 nonisolated：若某个方法或属性不需要访问 Actor 内部状态，可以显式标记为 nonisolated。此时，它可以直接被同步调用，但内部无法访问其他 actor-isolated 成员。

extension BankAccount {
    nonisolated var accountID: String { 
        // 不访问 balance 或其他隔离成员，可以是非隔离的
        return "ACCT-12345"
    }
    
    nonisolated func logID() {
        print(accountID) // ✅ 允许：访问非隔离属性
        // print(balance) ❌ 错误：无法访问 actor-isolated 属性
    }
}

5. 为什么需要这样设计？

数据竞争的预防：通过强制外部代码异步访问（排队等待 Actor 处理），确保同一时间只有一个任务修改 Actor 内部状态。
性能优化：Actor 内部的同步访问是高效的（无锁），而外部异步访问通过编译器检查保证安全。

总结表格

上下文	能否直接访问 `actor-isolated` 成员？	是否需要 `await`？
同一 Actor 的方法内部	✅ 是	❌ 否
外部代码	❌ 否（需通过 Actor 引用）	✅ 是
`nonisolated` 方法	❌ 否	❌ 否（不能访问）

通过这种机制，Swift 的 Actor 在编译阶段就能检测出潜在的数据竞争，使得并发代码更安全且易于维护。

Swift 中的 Scanner 类

Mon, 26 May 2025 21:52:28 +0800

Swift 中的 Scanner 类

Scanner 是 Swift 标准库中一个用于解析结构化字符串的实用工具类。它能够逐步扫描字符串内容，并从中提取特定类型的数据（如整数、浮点数、子字符串等），特别适用于处理格式化文本数据或自定义协议解析。

SwiftUI Modifier 功能与使用详解

Tue, 15 Apr 2025 21:36:44 +0800

SwiftUI Modifier 功能与使用详解

在 SwiftUI 中，Modifier（修饰符） 是一种用于修改或装饰视图的强大工具。它们允许你以声明式的方式调整视图的外观、布局或行为，而无需直接更改视图本身。Modifier 是 SwiftUI 设计理念的核心部分，遵循函数式编程的思想，通过链式调用来组合多个效果。

Mon, 01 Jan 0001 00:00:00 +0000

关于我

Hi，我是一位 iOS 开发者。

Posts Archive

Mon, 01 Jan 0001 00:00:00 +0000

Shaula Blog

iOS OSAllocatedUnfairLock

iOS 并发编程的新选择：OSAllocatedUnfairLock

iOS 异步操作重试机制

iOS 智能重试机制

React Native iOS 编译链接错误排查 - libc++ 缺失

React Native iOS 编译链接错误排查：libc++ 缺失

Swift 宏系统解析（二）：@freestanding(declaration)

Swift 宏系统解析（二）：@freestanding(declaration)

Swift 宏系统解析（一）：@freestanding (expression)

Swift 宏系统解析（一）：@freestanding (expression)

Objective-C 前向声明

Objective-C 前向声明: 不止是解决循环引用

Swift 6.1 Package Traits：让依赖管理更灵活

Swift 6.1 Package Traits：让依赖管理更灵活

为什么需要它？

基本用法

Swift - LRU 缓存

Swift - LRU 缓存

什么是 LRU 缓存？

iOS 跨平台代码中通过条件编译导入 UIKit 框架代码

iOS 跨平台代码中条件编译

Swift 中的 @preconcurrency

Swift 中的 @preconcurrency

iOS - VIPER 架构

iOS - VIPER 架构

SwiftUI 中的 ViewBuilder

SwiftUI 中的 ViewBuilder

iOS UIButtonConfiguration

iOS UIButtonConfiguration

为何需要 UIButtonConfiguration？

iOS 后台任务革新 - BGTaskScheduler

iOS 后台任务革新: BGTaskScheduler

Swift DFS 与 BFS 算法

Swift 中的 DFS 与 BFS 算法

iOS 动态方法调用 - NSInvocation

iOS 动态方法调用 - NSInvocation

iOS UIAction

iOS UIAction

什么是 UIAction？

Swift RegexBuilder

Swift RegexBuilder

Swift Actor隔离机制详解

Swift Actor隔离机制详解

1. Actor 的默认隔离规则

2. 同一 Actor 内部的自由访问

3. 外部代码的异步访问

4. 非隔离声明 (nonisolated) 的特殊性

5. 为什么需要这样设计？

总结表格

Swift 中的 Scanner 类

Swift 中的 Scanner 类

SwiftUI Modifier 功能与使用详解

SwiftUI Modifier 功能与使用详解

关于我

Posts Archive

什么是 `UIAction`？

4. 非隔离声明 (`nonisolated`) 的特殊性