google.github.io

Google TypeScript Style Guide

コードの品質や保守性を高めるためには、個人の癖に頼らない統一されたスタイルの確立が不可欠だ。Google TypeScript Style Guide は、大企業が長年培ってきた知見を凝縮した実践的なガイドラインであり、チーム開発から個人開発まで広く参考になる。

特に注目すべき主要なルールとその背景について解説する。

モジュール管理とインポート・エクスポートの原則

スタイルガイドでは、コードの可読性とビルドパフォーマンスを考慮した明確な制約を設けている。

  • デフォルトエクスポートの禁止: export default は使用せず、すべて export const や export class などの名前付きエクスポートを使用する。名前の表記揺れを防ぎ、リファクタリングを安全に行うためだ。
  • namespace の非推奨: TypeScript独自の namespace ではなく、ES6標準の import / export モジュール構文を使用することが義務付けられている。

言語機能の使い方とベストプラクティス

バグの原因となりやすいJavaScript由来の機能については、厳格な制限がかけられている。

  • 変数の宣言: var は一切禁止であり、基本は const を用い、再代入が必要な場合のみ let を使用する。
  • 配列・オブジェクトの初期化: Array() や Object() コンストラクタの使用を避け、リテラル構文（[] や {}）を採用する。
  • 型インポートの明示: 型情報のみを利用する場合は import type を明示することで、コンパイル速度の向上と不要なコードのバンドル防止を図る。

スタイルガイドを導入する意義

単に見栄えを整えるだけでなく、チーム全体でのコードレビュー負荷を減らし、潜在的なバグを未然に防ぐことがスタイルガイドの真の目的だ。優れたガイドラインを取り入れ、より堅牢で読みやすいプログラムを書く習慣を身につけていきたい。