DartのAPI設計：名前付き引数と位置引数の「境界線」を掌握する
Dartのコードを書いていると、「この引数、`[]`で囲むべきか、それとも`{}`で囲むべきか？」と迷う瞬間がありますよね。
Dartの関数シグネチャは非常に柔軟ですが、その柔軟性ゆえに「適当に設計すると後で地獄を見る」という側面もあります。今日は、Dartのコア・アーキテクチャの視点から、「なぜその設計にすべきなのか」という本質を紐解いていきましょう。
—
1. 位置引数とオプショナル引数：Dartの「型」の物語
Dartにおいて、引数の渡し方には大きく分けて「位置引数」と「名前付き引数」の2つがあります。
位置引数（Positional Arguments）
もっとも基本的な形です。
// 順番が絶対的なルール
void connect(String host, int port) { … }
ここがポイント： コンパイラは引数の「順序」で値を評価します。シンプルですが、引数が増えると「`connect(“localhost”, 80)`だっけ？ `connect(80, “localhost”)`だっけ？」という悲劇が起こります。
オプショナル位置引数（Optional Positional Arguments）
`[]`で囲む形式です。
// portは省略可能。デフォルト値は80
void connect(String host, [int port = 80]) { … }
ここがポイント： これは「順番に意味があり、かつ後続のものを省略したい」場合に有効です。しかし、中間の引数だけを飛ばすことはできません。
—
2. 名前付き引数（Named Arguments）の破壊力
Dartの真骨頂は`{}`で囲む「名前付き引数」にあります。Flutterのウィジェット構成を見れば一目瞭然ですね。
void createUser({required String name, int age = 18, bool isActive = true}) {
print(‘User: $name, Age: $age, Active: $isActive’);
}
// 呼び出し側
createUser(name: ‘DartMaster’, age: 25);
なぜ「名前付き引数」が優れているのか？
1. 自己文書化（Self-documenting）： `createUser(‘DartMaster’, 25, true)` と書くより、引数名が見えることでコードの意図が明確になります。
2. 順序の自由度： 呼び出し時に順番を気にする必要がありません。
3. 後方互換性： 後から引数を追加しても、呼び出し側のコードを壊しにくい（APIの拡張性が高い）。
—
3. API設計の「黄金律」：どちらを採用すべきか？
伝説的なDartコードベースの設計思想に基づくと、以下の基準で使い分けるのがベストです。
| 引数の性質 | 推奨する形式 | 理由 |
| :— | :— | :— |
| 必須かつ順序に意味がある | 位置引数 | `Point(x, y)`のように数学的・論理的に順序が確定している場合。 |
| 省略可能、または数が多い | 名前付き引数 | 引数が3つを超えたら名前付きを検討すべき。 |
| 設定（Configuration） | 名前付き引数 | `style: TextStyle(…)`のように、何を設定しているか明示したい場合。 |
「迷ったら名前付き引数にしておく」というのが、Dartにおける現代的なベストプラクティスです。特に`required`修飾子を併用することで、Null安全の恩恵を最大限に受けられます。
—
4. 陥りやすい罠：コンパイルエラーを回避するために
初心者がよくハマるポイントが「Null許容型」と「デフォルト値」の混同です。
// エラー例：デフォルト値がないのに必須でもない
void update({String? name}) { … }
// 正しい設計
void update({required String name}) { … } // 必須にする
void update({String name = ‘Guest’}) { … } // デフォルト値を持つ
Dartのコンパイラは、`String?`（Null許容）と「省略可能な引数」を厳格に区別します。`required`を付け忘れると、関数内でその値が`null`である可能性を考慮しなければならず、コードが`!`（強制アンラップ）だらけになるという「Null安全の負の遺産」が生まれます。
—
まとめ：Dartを掌握するということ
Dartの関数設計は、単なる文法の選択ではありません。「そのAPIを使う未来の自分やチームメイトへのメッセージ」です。
- 位置引数は「厳格さ」が必要な時に使う。
- 名前付き引数は「柔軟性と可読性」のために使う。
この境界線を意識するだけで、あなたの書くコードの品質は劇的に向上します。Dart VMは、型情報が明確であればあるほど最適化の余地が増え、より速い実行コードを生成します。型と引数設計を丁寧にすることは、実はパフォーマンス向上への近道でもあるのです。
ここをクリアしたあなたは、もうDartの初学者の殻を破っています。次はぜひ、`typedef`や`Function`型と組み合わせた、より高度なAPI設計に挑戦してみてくださいね。応援しています！