Swift開発 よくあるエラーと修正方法

このskillは、MochiLog開発中に発生したエラーとその修正方法を記録します。

エラー記録フォーマット

各エラーは以下の形式で記録:

• •日付: エラー発生日
• •エラー内容: エラーメッセージと状況
• •原因: なぜエラーが発生したか
• •修正方法: どう修正したか
• •予防策: 今後同じエラーを防ぐ方法

記録されたエラー

1. 文字列補間内のエスケープエラー (2026-02-08)

エラー内容:

Cannot find ')' to match opening '(' in string interpolation
Unterminated string literal

発生コード:

print("[Performance] 処理完了: \(String(format: \"%.2f\", elapsed))ms")

原因: 文字列補間\(...)の内部で\"を使用すると、Swiftのパーサーが混乱する。

修正方法:

// ✅ 正解
print("[Performance] 処理完了: \(String(format: "%.2f", elapsed))ms")

文字列補間の内部では、ダブルクォートをエスケープする必要はない。

予防策:

• •コード作成時: 文字列補間内では常に"を使用（\"を使わない）
• •コードレビュー時: grep -r 'String(format: \\"' . で検索
• •参考: swift-string-interpolation-guide.md

2. extensionからprivateプロパティへのアクセスエラー (2026-02-08)

エラー内容:

'appSettings' is inaccessible due to 'private' protection level

発生コード:

struct HomeView: View {
  private let appSettings = AppSettings.shared
}

extension HomeView {
  func someMethod() {
    appSettings.someProperty // ❌ エラー
  }
}

原因: Swiftでは、privateなプロパティは同じファイル内でも、extension内からはアクセスできない。

修正方法:

struct HomeView: View {
  let appSettings = AppSettings.shared // privateを削除
}

またはfileprivateを使用:

struct HomeView: View {
  fileprivate let appSettings = AppSettings.shared
}

予防策:

• •extensionで使用する可能性のあるプロパティはprivateにしない
• •fileprivateまたはinternal（デフォルト）を使用

使い方

エラー発生時

1. •このファイルを開く
2. •上記のフォーマットに従って新しいエラーを記録
3. •日付順に整理

参照時

1. •エラーメッセージで検索
2. •類似のエラーパターンを確認
3. •修正方法と予防策を適用

メンテナンス

エラーが20件を超えたら:

1. •カテゴリ別にファイルを分割（文字列、型、並行性など）
2. •errors/ディレクトリを作成
3. •インデックスファイルで一覧管理

関連リソース

• •swift-string-interpolation-guide.md - 文字列補間の詳細ガイド