Go開発ガイド

コードスタイル

• Effective Goガイドラインに従う
• フォーマットとインポート管理にgoimportsを使用する
• 関数は短く、焦点を絞った状態に保つ

一般的なパターン

• インターフェースを受け入れ、構造体を返す
• テーブル駆動テストを使用する
• エラーを明示的に処理し、無視しない
• キャンセルとタイムアウトにcontext.Contextを使用する

パッケージの構成

• パッケージ名は短く小文字に保つ
• 可能な限りパッケージレベルの状態を避ける
• プライベートパッケージにはinternal/を使用する

エラーハンドリング

• エラーを返す。パニックは起こさない(真に復旧不可能な状況を除く)
• コンテキストでエラーをラップする: fmt.Errorf("failed to connect: %w", err)
• 予期された条件にはセンチネルエラーを使用する

テスト

• テストを同じパッケージ(ホワイトボックス)または_testパッケージ(ブラックボックス)に配置する
• より明確なアサーションにはtestify/assertを使用する
• 独立したテストにはt.Parallel()を使用する

staticcheck

• すべてのリンター警告に対応する
• 一般的な問題: inef

...