前提知識：複数テンプレートの基本構成

まず、複数のHTMLテンプレートを結合する基本的な考え方を整理しましょう。

ベーステンプレート + 部分テンプレート構成

templates/base.html （完全なHTML構造）

<!DOCTYPE html>
<html>
<head>
    <title>{{.Title}}</title>
</head>
<body>
    <header>
        {{template "header" .}}
    </header>
    <main>
        {{template "content" .}}
    </main>
    <footer>
        {{template "footer" .}}
    </footer>
</body>
</html>

templates/header.html （部分テンプレート）

{{define "header"}}
    <nav>
        <a href="/">Home</a>
        <a href="/about">About</a>
    </nav>
{{end}}

templates/content.html

{{define "content"}}
    <h1>{{.Heading}}</h1>
    <p>{{.Content}}</p>
{{end}}

ポイントは、<html>タグなどの完全な構造を持つのは1つのベーステンプレートだけにし、他は{{define "name"}}で定義された部分テンプレートにすることです。

template.ParseFiles の特徴

メリット

1. 明示的なファイル指定

tmpl, err := template.ParseFiles(
    "templates/base.html",
    "templates/header.html", 
    "templates/sidebar.html",
    "templates/content.html",
)

どのファイルを読み込むかが一目瞭然で、チーム開発でも理解しやすいコードになります。

2. エラーの特定が容易
存在しないファイルがあれば即座にエラーとなり、問題の特定が簡単です。

3. 順序制御
ファイルの読み込み順序を明示的に制御できます。

4. セキュリティ面での安全性
意図しないファイルが読み込まれるリスクがありません。

デメリット

1. 手動管理の煩雑さ
新しいテンプレートファイルを追加するたびに、コードを修正する必要があります。

2. コードの冗長化
ファイル数が多くなると、記述が非常に長くなります。

3. 保守性の課題
ファイル名を変更した場合、対応するコードも修正が必要です。

template.ParseGlob の特徴

メリット

1. 自動検出による効率性

// パターンマッチで一括読み込み
tmpl, err := template.ParseGlob("templates/*.html")

// 階層別に読み込み
tmpl, err := template.ParseGlob("templates/layouts/*.html")

パターンにマッチするファイルを自動で検出・読み込みします。

2. コードの簡潔性
1行で複数ファイルを処理できるため、非常にシンプルです。

3. スケーラビリティ
新しいテンプレートファイルを追加するだけで、自動的に認識されます。

4. 開発効率の向上
ファイルの追加・削除時にコード修正が不要です。

デメリット

1. 制御の困難さ
どのファイルが読み込まれるか実行時まで不明で、予期しない動作の原因となる可能性があります。

2. 意図しないファイルの読み込み
.bakファイルや一時ファイルも読み込んでしまう可能性があります。

3. 順序の不確実性
ファイルの読み込み順序がファイルシステムに依存し、OS間で異なる可能性があります。

4. デバッグの困難さ
エラーが発生した際、どのファイルが原因かの特定が困難です。

使い分けの指針

ParseFiles を選ぶべき場面

小〜中規模プロジェクト - テンプレート数が管理可能な範囲
厳密な制御が必要 - 使用するテンプレートを明確にしたい
本番環境 - 予期しない動作を避けたい
チーム開発 - コードの可読性・理解しやすさを重視
重要なベーステンプレート - 確実に読み込みたいファイル

ParseGlob を選ぶべき場面

大規模プロジェクト - 多数のテンプレートファイルを扱う
プロトタイピング段階 - 開発速度を優先したい
規則的な命名規則 - ファイル名に一貫性がある
CMS的な用途 - テンプレートを動的に追加する場合
部分テンプレート - 細かいコンポーネントの管理

実践的なハイブリッドアプローチ

実際の開発では、両方の手法を組み合わせることで、それぞれの長所を活かせます。

func loadTemplates() *template.Template {
    tmpl := template.New("app")
    
    // 重要なベーステンプレートは明示的に管理
    tmpl = template.Must(tmpl.ParseFiles(
        "templates/base.html",
        "templates/layout.html",
        "templates/error.html",
    ))
    
    // 部分テンプレートは一括読み込みで効率化
    tmpl = template.Must(tmpl.ParseGlob("templates/partials/*.html"))
    tmpl = template.Must(tmpl.ParseGlob("templates/components/*.html"))
    
    return tmpl
}

実装例：Webハンドラーでの使用

package main

import (
    "html/template"
    "net/http"
)

var templates *template.Template

func init() {
    templates = loadTemplates()
}

func homeHandler(w http.ResponseWriter, r *http.Request) {
    data := struct {
        Title   string
        Heading string
        Content string
    }{
        Title:   "ホームページ",
        Heading: "Go Template Example",
        Content: "ParseFilesとParseGlobの使い分け例です",
    }
    
    err := templates.ExecuteTemplate(w, "base.html", data)
    if err != nil {
        http.Error(w, err.Error(), 500)
    }
}

func main() {
    http.HandleFunc("/", homeHandler)
    http.ListenAndServe(":8080", nil)
}

パフォーマンス考慮事項

初期化時の読み込み戦略

// 本番環境：起動時に一括読み込み
func init() {
    templates = loadTemplates()
}

// 開発環境：リクエストごとに再読み込み（ホットリロード）
func devHandler(w http.ResponseWriter, r *http.Request) {
    tmpl := loadTemplates() // 開発時のみ
    err := tmpl.ExecuteTemplate(w, "base.html", data)
    // ...
}

まとめ

項目	ParseFiles	ParseGlob
制御性	★★★★★	★★☆☆☆
開発効率	★★☆☆☆	★★★★★
デバッグ性	★★★★★	★★☆☆☆
スケーラビリティ	★★☆☆☆	★★★★★
安全性	★★★★★	★★★☆☆

両手法にはそれぞれ明確な特徴があり、プロジェクトの要件に応じて適切に選択することが重要です。多くの場合、ハイブリッドアプローチが最も実用的な解決策となるでしょう。

適切なテンプレート管理により、保守性が高く効率的なGoアプリケーションを構築していきましょう！