Go言語の命名規則完全ガイド：パッケージ・頭字語・レシーバの実践ルール

package mypackage

// Exported（公開）: パッケージ外からアクセス可能
type User struct {
    Name  string  // 公開フィールド
    email string  // 非公開フィールド
}

// Exported function
func NewUser(name, email string) *User {
    return &User{Name: name, email: email}
}

// unexported function（パッケージ内からのみ）
func validateEmail(email string) bool {
    return len(email) > 0
}

// 良い例
package httputil
package stringconv
package nethttp

// 悪い例
package http_util    // アンダースコアはNG
package httpUtil     // キャメルケースはNG
package HttpUtil     // 大文字始まりはNG

// 使う側から見たときのわかりやすさを重視
import (
    "net/http"      // http.Get()、http.Post()と書ける
    "encoding/json" // json.Marshal()と書ける
)

// 公開型と非公開型
type DatabaseConfig struct { ... }  // 公開
type internalState struct { ... }   // 非公開

// 公開関数と非公開関数
func ProcessRequest(r *http.Request) {}  // 公開
func parseHeaders(r *http.Request) {}    // 非公開

// 変数
var MaxRetries = 3       // 公開変数
var defaultTimeout = 30  // 非公開変数

// ループカウンタ: i, j, k で十分
for i := 0; i < 10; i++ { ... }

// 関数スコープ: 意味が伝わる短い名前
func process(r *http.Request) {
    b, err := io.ReadAll(r.Body)
    ...
}

// パッケージスコープ: より説明的に
var requestTimeout = 30 * time.Second

// 正しい例
type HTTPClient struct { ... }    // 公開: HTTP全大文字
type XMLParser struct { ... }     // 公開: XML全大文字
type urlValidator struct { ... }  // 非公開: url全小文字

var userID int                    // 非公開: ID全大文字NG → id全小文字
var UserID int                    // 公開: UserIDが正しい（IDを全大文字に）

// 間違った例
type HttpClient struct { ... }    // NG: 混在表記
type XmlParser struct { ... }     // NG: 混在表記
var userId int                    // NG: 大文字D、小文字i の混在

// 複合的な例
func ServeHTTP(w http.ResponseWriter, r *http.Request) {}
// HTTP: 全大文字（Goの標準インターフェース名）

type APIResponse struct {
    StatusCode int
    RequestID  string  // ID は全大文字
}

// Goの正しい定数定義
const (
    MaxConnections = 100     // 公開定数: PascalCase
    defaultTimeout = 30      // 非公開定数: camelCase
    StatusOK       = 200     // 公開定数
)

// 間違った書き方（他言語の慣習をそのまま持ち込んだ例）
const (
    MAX_CONNECTIONS = 100    // NG: Goでは使わない
    DEFAULT_TIMEOUT = 30     // NG
)

type Server struct {
    addr string
    port int
}

// 正しい: 型名の略語（Server → s）
func (s *Server) Start() error {
    return listenOn(s.addr, s.port)
}

func (s *Server) Stop() {
    // ...
}

// 間違い: self や this は使わない
func (self *Server) Start() error { ... }  // NG
func (this *Server) Start() error { ... }  // NG

type DatabaseClient struct { ... }

// 良い例: 全メソッドで db を統一
func (db *DatabaseClient) Query(sql string) {}
func (db *DatabaseClient) Close() error { return nil }
func (db *DatabaseClient) Ping() bool { return true }

// 関数スコープのエラーは単純に err
result, err := doSomething()
if err != nil {
    return err
}

// エラー型の変数（パッケージレベル）は Err プレフィックス
var ErrNotFound = errors.New("not found")
var ErrTimeout = errors.New("timeout")

// カスタムエラー型は Error サフィックス
type ValidationError struct {
    Field   string
    Message string
}

func (e *ValidationError) Error() string {
    return fmt.Sprintf("%s: %s", e.Field, e.Message)
}

// 標準ライブラリの例
type Reader interface {
    Read(p []byte) (n int, err error)
}

type Writer interface {
    Write(p []byte) (n int, err error)
}

type Stringer interface {
    String() string
}

// 自分で定義する場合も同様
type Fetcher interface {
    Fetch(url string) ([]byte, error)
}

type Validator interface {
    Validate() error
}