こんにちは！FlutterやDartでの開発を楽しんでいますか？
他のプログラミング言語、例えばJavaScriptやJava、Swiftなどを触ってきた方ほど、Dartの非同期処理（`async/await`）とループ処理を組み合わせたときに、「あれ、思った通りに動かないぞ？」という壁にぶつかりがちです。
特に、リストの要素を一つずつ順番に非同期処理したい場面で `forEach` を使ってしまい、カオスなバグを生んでしまうのは、誰もが一度は通る道なんですよね。
今回は、Dartの `for-in` と `forEach` の決定的な違いを、Dart VMの裏側の動きやイテレータの仕組みまで少しだけ覗き見しながら、優しく、そして深く解き明かしていきます。ここをクリアすれば、Dartの非同期制御はもうバッチリマスターできますよ！
—
1. 最初に結論：なぜ非同期処理では `for-in` が推奨されるのか？
いきなり結論からお伝えしますね。
- `for-in` ループ：非同期処理（`await`）を「順番に（直列に）」待って実行してくれます。
- `forEach` メソッド：非同期処理を「無視して（並行に）」一気に発射し、ループ自体の完了を待ちません。
安全で予測可能なコードを書きたいとき、非同期処理が絡むループでは基本的には `for-in` を選ぶのがDartにおける大正解です。
では、なぜこのような違いが生まれるのか、それぞれの裏側の仕組みを解き明かしていきましょう。
—
2. `forEach` の正体と、非同期処理における「罠」
まずは、多くの言語で親しまれている `forEach` から見てみましょう。
// 良くない例：forEachの中でawaitを使う
void processItems(List
items.forEach((item) async {
await fetchServerData(item); // サーバーからデータを取得する非同期処理（擬似コード）
print(‘Processed: $item’);
});
print(‘All done?’);
}
このコードを実行したとき、コンソールにはどのような順番で文字が表示されると思いますか？
「上から順に処理されて、最後に ‘All done?’ と出るんでしょ？」と思いきや、実際の出力はこうなります。
All done?
Processed: item1
Processed: item2
Processed: item3
(※処理の速度によっては順番が前後することもあります)
なぜこうなるのか？（裏側の仕組み）
`forEach` は、Iterable（反復可能オブジェクト）が持つ単なる高階関数（メソッド）です。中身を覗いてみると、単に渡されたコールバック関数を要素の数だけ同期的に呼び出しているだけなんですね。
// イメージとしての forEach の実装
void forEach(void f(E element)) {
for (E element in this) {
f(element); // ここでコールバックを呼ぶだけで、戻り値（Future）を一切awaitしない！
}
}
`forEach` に渡した `async` 関数は、最初の `await` に到達するまでの処理を即座に実行し、`Future` を返しますが、`forEach` 側はその `Future` を受け取って待ってくれるわけではありません。そのため、ループの枠組み自体は一瞬で最後まで走り抜け、最後に「All done?」が先に出力されてしまうのです。
さらに恐ろしいことに、これではエラーハンドリング（`try-catch`）も正常に機能せず、非同期処理の実行順序が保証されないため、データベースの更新や順番が命の処理で致命的なバグを引き起こします。
—
3. `for-in` ループの美しさと「イテレータ」の挙動
一方で、Dartの `for-in` 文は、コンパイラとDart VMによって特別に扱われる制御構文です。
// 良い例：for-inでawaitを使う
Future
for (var item in items) {
await fetchServerData(item); // しっかり完了を待ってから次のループへ進む
print(‘Processed: $item’);
}
print(‘All done!’);
}
このコードの出力結果は、期待通りにこうなります。
Processed: item1
Processed: item2
Processed: item3
All done!
なぜ `for-in` だと順番通りに動くのか？
`for-in` の裏側では、Dartの `Iterator`（イテレータ） が静かに、しかし正確に働いています。
Dartの `for-in` は、概念的には次のようなコードにコンパイル時に展開されています。
// for-in の内部挙動のイメージ
var iterator = items.iterator;
while (iterator.moveNext()) {
var item = iterator.current;
await fetchServerData(item); // awaitがあるため、ここで実行が一時停止する
}
ポイントは、`await` があることで、次の `iterator.moveNext()`（次の要素へ進む処理）が、前の非同期処理が完了するまで絶対に呼ばれないという点です。
これにより、完全に直列化された安全な非同期ループが実現できるというわけですね。Dart VMにとっても、この構造であればIsolateのイベントループ上でタスクを綺麗に順番通りに処理しやすくなります。
—
4. ちょっと応用：どうしても並行（同時）に処理したいときは？
「いや、順番に処理するんじゃなくて、リストの全要素に対して同時にリクエストを飛ばしたいんだ！」というパフォーマンス重視の場面もありますよね。
そんなときは、`forEach` で無理やり頑張るのではなく、`Future.wait` と `map` を組み合わせるのがDartのイディオム（慣用句）として最も美しく、安全です。
// 全ての要素に対して「同時並行」で非同期処理を走らせ、すべて終わるのを待つ
Future
// 1. 各要素のFutureのリストを作る
Iterable
await fetchServerData(item);
print(‘Processed: $item’);
});
// 2. すべてのFutureが完了するのを一括で待つ
await Future.wait(futures);
print(‘All done concurrently!’);
}
これなら、「並行処理をしたいときは `map` + `Future.wait`」「直列処理をしたいときは `for-in` + `await`」という明確なメンタルモデル（使い分けの基準）が持てますよね。
—
まとめ
今回のポイントをサクッと振り返ってみましょう！
1. `forEach` は非同期処理を待ってくれない
- コールバックを呼び捨てる形になるため、順番がバラバラになり、エラーハンドリングも困難になります。
2. 非同期処理の直列実行には `for-in` を使う
- イテレータの仕組みと `await` が綺麗に噛み合い、上から順に確実に処理を進められます。
3. 並行処理をしたいなら `map` と `Future.wait` を活用する
- 用途に合わせて適切な道具を選ぶことが、堅牢なDart/Flutterアプリを作る第一歩です。
Dartの非同期処理は、その裏側のイベントループやFutureの挙動を理解すると、驚くほどロジカルで書きやすいものに変わります。
ここをクリアできれば、あなたのDartコードはワンランク上のクオリティになりますよ。一緒に楽しくコードを書いていきましょう！