はじめに
Swiftで開発をしていると、
「処理がちゃんと動いているか」「値が正しく取得できているか」
を確認したい場面が出てきます。
この記事では、Xcodeのコンソールにログを出力する基本的な方法をまとめます。
ログ出力の方法
まずは、Xcodeでのデバッグエリアの表示方法についてですが、
・View > Debug Area > Activate Console を選択。
※以下、私が忘れないようにするためのスクショです。
スクリーンショット 2026-03-23 17.07.48.png
Swiftでは print() を使うことで、簡単にコンソールへログを出力できます。
ログの書き方の基本(key-value形式)
ログは "項目名(Key): 値(Value)"(Key-Value形式) で書くと、後から見返した時に何のデータか判別しやすくなります。
print("action: search, city: Tokyo")
// 出力: action: search, city: Tokyo
どこに書くのが効果的?
ここに関しては、まだ私の試行錯誤中ではありますが、調べる中で
ログを書く「場所」を工夫するだけで、バグの原因特定がぐっと早くなると思ったので、
以下をまとめました。個人的に意識してやっていきたいと思います。
※サンプルコードはGeminiに出力してもらった結果となります。
- 「分岐(if文)」の中に書く
プログラムが自分の意図通りに枝分かれしているかを確認するために、分岐の中に書くのが鉄則です。
Swift
if userAge >= 20 {
print("check: 20歳以上(処理を実行します)")
} else {
print("check: 20歳未満(スキップします)")
}
- 処理を「サンドイッチ」する
重い処理やデータの読み込みを行う際、**「処理の直前」と「直後」**にログを挟みます。
Swift
print("start: データ取得開始")
fetchData() // 実行したい処理
print("end: データ取得完了")
もしコンソールに start しか出なければ、「fetchData の中で止まっている」ということが即座にわかります。
ログの種類
まだ私は使ったことないが、上記で説明した以外にも以下があるらしいです。ここに関しては、私も勉強しながら理解を深めていきたいです。
・debugPrint()
・dump()
まとめ
-
print()で簡単にログ出力できる - デバッグ時に非常に重要な基本スキル
- ログを出力する「場所」のポイントは、**「分岐の中」や「処理の前後」**が良い
ログ出力はバグ調査の第一歩なので、積極的に活用していきましょう。!