Swiftを書く
初期応答
このスキルが特定の質問なしに最初に呼び出された場合、次のようにのみ応答します:
モダンなSwiftを、言語が意図する方法で書くお手伝いをします。
ユーザーが質問するまで、その他の情報は提供しないでください。
言語が意図する方法でSwiftを書く方法。Swift 6.4まで対応。
ツールチェーンベースライン:Swift 6.3(2026年8月時点の最新リリース)。ここに記載されている内容は、特に注記がない限り6.3でコンパイルできます。⚠ マークは未リリースのSwift 6.4機能を示します。並行性のガイダンスはSwift 6.2モデルを前提としています。プロジェクトが6.1以前の場合は、§3のasyncと@concurrentに関するルールは適用されません。
一貫したテーマ:Swiftは段階的に開示される言語です。最もシンプルで、最も静的で、最もシングルスレッドな、動作するものから始め、動的要素(並行性、参照セマンティクス、存在型、安全でないポインタ)は、その理由を明確に示せる場合にのみ導入します。 以下のすべてのルールは、この原則の適用です。
このデフォルトの階層をモデル化します。理由を明確に示せる場合にのみ、1つ下のレベルに移動します:
| ニーズ | 最初に使うもの | 次の場合にのみダウングレード |
|---|---|---|
| データ | struct / enum | 同一性、共有、継承が必要な場合 |
| 抽象化 | 具体的な型 | 型をまたがる繰り返しコードがある場合 |
| ポリモーフィズム | some P (ジェネリック) | 異種ストレージが必要 → any P |
| 実行 | メインアクター、同期的 | プロファイリングでハングが判明 → async → @concurrent → actor |
| メモリ | Array, String | プロファイリングでコストが判明 → InlineArray, Span |
| 安全性 | 安全なAPI | C相互運用または測定されたホットパス → Unsafe* |
1. 値型でデータをモデル化する
値型はSwiftのデフォルトであり、特別なケースではありません。
- デフォルトで
structとenumを使用します。classは、同一性、共有可変状態、継承、またはリソースのライフタイムが必要な場合にのみ使用します。 ウィンドウ、データベース接続、レンダリングエンジンに格納されたエンティティには同一性があります。Point、Drink、Materialにはありません。 - デフォルトで
letを使用し、変更する場合のみvarを使用します。 これは、someをanyの前に、値を参照の前に置くのと同じ規律です。狭く始め、理由があって広げます。 - 可変な参照型プロパティを持つ構造体は、値でも参照でもありません。 コピーはオブジェクトを共有し、変更はコピー間で漏洩します。参照される型を不変に保つか、それに転送する計算プロパティのみを公開するか、コピーオンライトの背後にある
privateな格納プロパティにします。 - コピーオンライトは、アウトオブラインストレージと値セマンティクスの両方を実現する方法です。 最終クラスを構造体でラップし、変更前に
isKnownUniquelyReferenced(&storage)をチェックします。一意でない場合は最初にコピーします。これこそがArray、String、Dictionaryが機能する仕組みです。 - Enumは「固定されたものの集合」と相互に排他的な状態のためのツールです。 オプショナルな格納プロパティの山(
isSharing、selectedRows、shareTarget)を1つのenum Stateに置き換えることで、無効な組み合わせを表現不可能にし、状態変更を、完了し忘れる可能性のある一連のプロパティ書き込みではなく、アトミックにします。 - 値を組み合わせると値が得られます。 格納プロパティがすべて値型である構造体は、無料で値セマンティクスを持ちます。これにより、アンドゥ、差分、状態復元が、プロパティごとに1つではなく、単一のコードパスになります。
struct Material { // 値セマンティクスが保持される
var roughness: Double
private var _texture: Texture // クラス
var color: Color {
get { _texture.color }
set {
if !isKnownUniquelyReferenced(&_texture) { _texture = Texture(copying: _texture) }
_texture.color = newValue
}
}
}
非コピー可能型(~Copyable)は、ファイルディスクリプタ、銀行振込、開かれたリソースなど、一意の所有権を表現します。コピーを抑制することで、「これを2回実行してはならない」というルールを、アサーションからコンパイルエラーに変え、構造体でのdeinitを意味のあるものにします。終了メソッドをconsumingとマークすることで、コンパイラがそれが最後の使用であることを証明できるようにします。パラメータの所有権は明示的になります:borrowing(読み取り専用、デフォルト)、consuming(受け取って所有権を奪う)、inout/mutating(一時的な書き込みアクセス)。
2. エラーとオプショナル—失敗パスを見えるようにする
Swiftのエラー処理は3つのポイントに基づいています。エラーの発生源はマークされているため、驚かされることはありません。エラーは対処するための十分なコンテキストを持ちます。そして、回復可能なエラーはプログラマのミスとは異なります。
- 回復可能 →
throw。プログラマのミス →precondition/fatalError。 ネットワーク呼び出しの失敗はプログラムを実行し続けます。範囲外のインデックスはコードが間違っていることを意味し、バグがセキュリティ問題になる前に停止しなければなりません。 - 関連値を持つEnumは最良のエラー型を作ります。
case duplicateFriend(String)はcase duplicateFriendよりも優れています—コンテキストがすべてです。 - エラー条件には
guardを使用します。なぜなら、終了パスを強制するからです。通常のアンラップにはif letを使用します。 - 型付きスロー(
throws(MyError))は、内部関数、エラー転送ジェネリックコード、および制約された環境向けです。any Errorのボクシングが高コストすぎる場合に使用します。公開APIの場合、型なしのthrowsは、後でエラー型を変更する自由を保持します。統合に注意:throwsはthrows(any Error)であり、非スローはthrows(Never)です—これにより、mapが両方を抽象化できるようになります。 - 強制アンラップは、不変条件を明確に示せる場合にのみ使用し、裸の
!よりも、メッセージ付きの失敗する#require/preconditionを優先します。
3. 並行性:プロファイリングで別の指示があるまで、シングルスレッドを維持する
このセクションは、エージェントが最も頻繁に間違えるセクションです。なぜなら、モデルがSwift 6.2で変更されたからです。
すべてのアプリをメインスレッドで完全に開始します。シングルスレッドコードは長い道のりをカバーでき、ほとんどのアプリはそれから離れる必要がありません。
順序に従った進行。ステップをスキップしないでください。
- メインアクター上のシングルスレッド。 並行性は一切なし。ほとんどのアプリに適しています。
async/awaitでレイテンシ(ネットワーク、ディスク)を隠蔽します。依然として独自の並行性はありません—URLSession.data(from:)のようなSDK APIが代わりにオフロードします。@concurrentで、_あなたの_高コストな処理をメインスレッドから移動します—Instrumentsがハングを示した後にのみ。actorで、_状態_をメインアクターから移動します—メインアクターの状態が多すぎて、タスクが常に戻ってくることを強制されている場合にのみ。
最初に正しいビルド設定を有効にします。 すべてのプロジェクトで親しみやすい並行性を有効にします。アプリモジュールとUI向けモジュールでは、デフォルトのアクター分離もMainActorに設定します—これはXcode 26の新しいアプリプロジェクトのデフォルトであり、@MainActorアノテーションのほとんどを削除します。パッケージ内:swiftSettings: [.defaultIsolation(MainActor.self)]。汎用ライブラリにメインアクターデフォルトを設定しないでください—ライブラリはnonisolated APIを出荷し、クライアントに処理の実行場所を決定させるべきです。
変更されたルール
Swift 6.2では、関数をasyncとマークしても、現在のアクターから移動しません。 呼び出された場所で実行されます。これにより、「最も自然なコードを書くこと」がデフォルトでデータ競合フリーになります。
@concurrent— 常に並行スレッドプールに切り替えます。_あなたの_CPU負荷の高い処理に使用します。nonisolated— 呼び出された場所で実行されます。これはライブラリAPIの正しいデフォルトです。なぜなら、呼び出し元が決定するからです。型に対するnonisolatedは、そのメンバーすべてを非分離にします(Swift 6.1以降)。- どちらでもない — 呼び出し元のアクターに留まります。
nonisolated struct PhotoProcessor { // メインアクターから切り離す
@concurrent // バックグラウンドで実行されることが保証される
func process(_ data: Data) async -> ProcessedPhoto {
async let sticker = extractSticker(data) // 2つの独立したジョブ、並列に
async let colors = extractColors(data)
return await ProcessedPhoto(sticker: sticker, colors: colors)
}
}
- オフロードする前にプロファイリングします。 Instruments(Time Profiler、ハング)を使用します。並行性なしでコードを高速化できる場合は、常にそれを先に行います。並行性には実際のコスト(タスク割り当て、スケジューリング、推論)がかかります。
- 些細な処理のためにタスクを生成しないでください。
UserDefaults値を読み取るための子タスクは、節約する以上のコストがかかります。 - エンドツーエンドの操作ごとに1つのタスク。 順番に実行する必要がある処理は_1つの_タスクに入れます。独立した操作は別々のタスクに入れ、ランタイムがそれらをインターリーブできるようにします。
awaitはサスペンションポイントであり、アトミック性を壊します。 サスペンド中に状態が変化する可能性があり、別のスレッドで再開される可能性があります。すべてのawaitの後に前提条件を再確認します。awaitをまたいでロックを保持しないでください。awaitをまたいでスレッドローカルストレージに依存しないでください。
アクターの再入可能性
アクターは相互排他を保証しますが、トランザクションは保証しません。同じアクター上の2つのawaitの間に、他の処理が実行されます。
- 同期メソッドでアクターの状態を変更します。 アクター上の同期コードは中断されずに実行されます—それがトランザクション境界です。
- 非同期アクターメソッドは薄く保ち、同期トランザクション操作で構成し、すべての
awaitでアクターを一貫した状態に保ちます。 - 古典的なバグ:キャッシュを確認 →
awaitダウンロード → キャッシュに書き込み。2つのタスクが両方ともミスし、両方ともダウンロードし、2番目が最初のものを上書きします。awaitの後に再確認するか、実行中の処理を重複排除します。 - アクターはFIFOではありません。 優先順位の逆転を正確に回避するために、最も優先度の高い処理を最初に実行します。順序付けが必要な場合は、アクターではなく、タスク(開始から終了まで実行される)または
AsyncStreamを使用します。
4. Sendableとデータの共有
Sendableは、分離ドメイン間で共有しても安全な型をマークします。コンパイラは、すべてのタスクとアクターの境界でそれをチェックします。
- 値型は、そのストレージが
Sendableである場合にSendableになります—公開されていない型の場合は自動的に推論されます。公開型は送信可能性が推論されることはありません:公開型をSendableとマークすることはクライアントへの約束であるため、Swiftはそれを明示的に記述することを要求します。 - アクターと
@MainActorクラスは暗黙的にSendableです。なぜなら、それらの状態は分離されているからです。 - ほとんどのモデルクラスは、
@MainActorでもSendableでもあるべきではありません。 意図的に非Sendableに保ちます—これにより、モデルの半分がメインスレッドで変更され、残りの半分がバックグラウンドで変更されるのを防ぎます。メインアクターを離れる必要がある場合は、Sendableではなくnonisolatedにします。 - 送信側が使用を停止する限り、非
Sendableオブジェクトをドメイン間で_送信_することもできます。 引き渡す_前に_すべての変更を行います。その後で触れるとエラーになります。 - クロージャも状態をキャプチャします。関数型が実際にドメインをまたぐ場合にのみ、
@Sendableとマークします。 @unchecked Sendableは、コンパイラがチェックできない約束です。 実際の内部同期(Mutex、ロック)を持つ型のために予約します。グローバルでのnonisolated(unsafe)も同様—最後の手段であり、警告の抑止力ではありません。
データ競合エラーに遭遇したときは、このリストを順に確認します:
- 共有しない。 共有オブジェクトをローカルに移動し、各並行ジョブが独自のインスタンスを取得するようにします。(これは圧倒的多数の実際のエラーの修正です。)
Sendableな値型にする ことで、「共有」を実際にコピーにします。- アクターに分離する —メインアクター、または独自のアクター。
- その後にのみ、
SynchronizationモジュールのMutex/Atomic(letプロパティに格納)、または@unchecked Sendableに手を伸ばします。
グローバル変数と静的変数は、最も一般的なエラーの原因です。 優先順位:letにする;@MainActorに置く;Mutexでラップする;nonisolated(unsafe)。Cとは異なり、Swiftのグローバルは遅延_かつ_アトミックに初期化されることに注意してください。
古いコールバックAPIのブリッジング: 自分が所有する場合は、デリゲートプロトコルに@MainActorの注釈を付けます。所有していない場合は、メソッドをnonisolatedとマークし、MainActor.assumeIsolated { }を使用します—これはホップする代わりにアサートするため、静かに競合する代わりに大声でトラップします。準拠での@preconcurrencyは、同じことの省略形です。@preconcurrency importを使用して、移行していないモジュールからの送信可能性警告を一時的に抑制します。移行が完了すると、警告は—正しく—再表示されます。
5. 構造化並行性
常に構造化タスクを優先します。
構造化タスク(async let、タスクグループ)はローカル変数のようにスコープされます。ブロックを超えて存続できず、自動的に待機され、タスクツリーを通じてキャンセル、優先順位、タスクローカル値を継承します。非構造化タスク(Task { }、Task.detached)は、それらのいずれも自動的には提供しません。
async let— 固定された、静的に既知の数の並行子タスクに使用します。withTaskGroup— 数が動的な場合に使用します。タスクグループはAsyncSequenceに準拠します—結果が到着した時点で反復処理します。子タスクが何も返さない場合は、withDiscardingTaskGroupを使用します。これは各子のリソースを即座に解放し、最初のエラーで兄弟タスクをキャンセルします。Task { }— 処理のライフタイムがスコープに収まらない場合のみ—デリゲートコールバック、ボタンタップ、ビューの表示への反応など。アクター分離と優先順位を継承しますが、キャンセルは自分で管理する必要があります。Task.detached— ほとんど使用しません。何も継承しません—分離も、優先順位も、タスクローカルも。切り離されたルートが必要な場合は、繰り返し切り離すのではなく、_その中に_タスクグループを配置します。
キャンセルは協調的です。 キャンセルはフラグを設定します。何も停止しません。高価な処理を開始する前、および同期ヘルパー内でも、Task.isCancelled または try Task.checkCancellation() をチェックします。サスペンド中(AsyncSequenceのnext()など)の処理の場合は、withTaskCancellationHandler を使用します—そして、ハンドラーは本体と即座に並行して実行されるため、タッチする状態は実際の同期(アクターではなく、アトミックまたはロック—アクター上での順序付けは保証できません)を必要とすることを忘れないでください。
並行性を制限します。 無制限のリストのアイテムごとに1つの子タスクをファンアウトしないでください。N個の子タスクを開始し、その後さらに追加します。
6. プロトコルと存在型
抽象化のデフォルトは具体的な型です。 プロトコルは、複数の型にわたって繰り返されるコードがある場合にのみ使用します。
some P( opaque result type / ジェネリックパラメータ)は、デフォルトのポリモーフィズムツールです。コンパイル時のディスパッチ、値型のサポート、オーバーヘッドなし。 型消去(any P)は、ストレージに異種性がある場合、またはリフレクションが必要な場合にのみ使用します。any Pはボックスです。 ヒープ割り当て、参照カウント、動的ディスパッチを使用します。some Pが必要ない場所でany Pを使用しないでください。someとanyの区別は意味的です。someは「この関数は特定の1つの型を返します」と言います。anyは「型は異なる可能性があります」と言います。戻り値の型にanyを使用すると、動的ディスパッチが発生しますが、someは静的な型のままにします。- プロトコルに
associatedtypeまたはSelf要件がある場合、それはジェネリックパラメータとしてのみ使用できます(some P)。any Pは使用できません。 anyは常に16ワードを使用します(値が収まらない場合はヒープ割り当て)。プロトコルは自立型ブリッジングを使用してこれに対処します。- プロトコルは最小限にします。 単一の要件を持つ小さなプロトコルが最適です。大きなプロトコルは、多くの場合、複数の小さなプロトコルに分割できます。
EquatableとHashableは自動合成されます—すべての格納プロパティがそれらに準拠している場合。Codableも同様に合成されます が、CodingKeys列挙型を追加して、エンコード/デコード方法をカスタマイズできます。
7. ジェネリクス(some vs any)
some Pは、具体的な型を非公開にしながら使用できます。 関数が特定のP準拠型を返すが、その型を非公開にしたい場合に使用します。- ジェネリック関数は、最も一般的な形式です:
func foo<T: P>(_ t: T)。some Pは糖衣構文であり、まったく同じ意味を持ちます。 any Pは型消去であり、異種コレクションに役立ちます:let items: [any P] = [A(), B()]。同じ抽象化の下で異なる型を持つことができる場合に使用します。some Pを戻り値の型として使用する場合、関数は毎回同じ具体的な型を返さなければなりません。異なる可能性がある場合は、戻り値の型にany Pを使用します。someとanyを切り替えることは、パフォーマンスと柔軟性のトレードオフです。 具体的な型がわかっている場合はsomeを使用し、異種性が必要な場合はanyを使用します。
8. ARCとメモリ管理
- ARCは自動的ですが、サイクルには注意してください。 弱参照(
weak)または所有権なしの参照(unowned)を使用して、クロージャとデリゲート内の強参照サイクルを断ち切ります。 weakは実行時コストがかかります。 参照はオプショナルとして扱われ、ARCは参照先のオブジェクトが解放されたときにnilに設定します。unownedは、参照先のオブジェクトが自分より長く生きることを確信している場合に使用します。 安全上の理由から、weakを好みます。- クロージャは、キャプチャリスト(
[weak self]、[unowned self])を使用して、キャプチャされた値を明示的に管理します。 - コピーオンライト は、大きな値型のコストを効率的に管理するための主要なツールです。
9. Swift Testing
import Testingを使用します。XCTestよりも優先されます。@Testでテストをマークします。 非同期テストはデフォルトでサポートされています。- アサーションには
#expectを使用します。 これはXCTAssertEqualなどを置き換えます。 - テストを整理するには
@Suiteを使用します。 スイートはネストでき、タグでフィルタリングできます。 - パラメータ化されたテストには
@Test(arguments:)を使用します。 withKnownIssueを使用して、既知の問題をマークします。#expect(throws:)を使用して、エラーがスローされることをテストします。
10. マクロ
- マクロはコンパイル時にコードを生成します。 定型コードを削減するために使用します。
@freestanding(expression)マクロ は式を生成します。@attachedマクロ は、型や関数にコードを追加します。- マクロを実装するときは、SwiftSyntax を使用します。
@mainを使用してマクロをエクスポートします。- マクロのターゲットには
@mainを使用します。
11. パッケージ管理
Package.swiftを使用して依存関係を管理します。swift-tools-version:を最新の安定版に設定します。- ターゲットには
targets:を使用します。 dependencies:を使用して外部パッケージを追加します。products:を使用して、ライブラリや実行可能ファイルを定義します。swiftSettings:を使用して、コンパイラフラグと設定を構成します。
12. パフォーマンス
- プロファイリングは推測の代わりになります。 Instruments を使用して、問題が発生している場所を特定します。
- 値型は参照型よりもはるかに安価です。 値型はヒープ割り当てが不要で、スレッドセーフです。
ContiguousArrayは、参照型の配列にArrayよりも効率的です。some Pはany Pよりも高速です。 これは動的ディスパッチを回避します。- 弱参照は実行時コストがかかります。
weakの使用を最小限にします。 @inlinableを使用して、モジュール境界を越えてコードをインライン化します。@_exportedを使用して、モジュールを再エクスポートします。