パッケージ / import

// パッケージ宣言です。ファイルの先頭に書きます。
package main

// 単一インポートです。
import "fmt"

// 複数インポート（グループ化推奨）です。
import (
    "fmt"
    "math"
    "strings"
)

// エイリアスを付けてインポートします。
import f "fmt"  // f.Println() で使えます。

// ブランクインポート：初期化処理だけ実行します（使わない場合はコンパイルエラーを回避）。
import _ "image/png"

// ドットインポート：パッケージ名なしで使えます（非推奨）。
import . "fmt"  // Println() のように書けます。

// 大文字始まりの識別子は外部から参照できます（エクスポート）。
func PublicFunc() {}   // 他パッケージから呼べます。
func privateFunc() {}  // 同じパッケージ内でのみ使えます。

// ファイル: main.go
package main

import (
    "fmt"
    "strings"

    // エイリアスを使う例です。
    m "math"

    // ブランクインポート：side effectのためだけにインポートします。
    _ "net/http/pprof"
)

// Greeting は外部からも使えるエクスポートされた関数です。
func Greeting(name string) string {
    return "Hello, " + name + "!"
}

// greet は同パッケージ内でしか使えない非公開関数です。
func greet(name string) {
    fmt.Println(Greeting(name))
}

func main() {
    // 標準パッケージを使います。
    fmt.Println("=== パッケージとインポートの例 ===")

    // strings パッケージを使います。
    s := "  Hello, Go!  "
    fmt.Println("Trim:", strings.TrimSpace(s))
    fmt.Println("Upper:", strings.ToUpper(s))

    // エイリアスを付けた math パッケージを使います。
    fmt.Printf("Pi: %.4f\n", m.Pi)
    fmt.Printf("Sqrt(2): %.4f\n", m.Sqrt(2))

    fmt.Println()

    // エクスポートされた関数を呼び出します。
    fmt.Println(Greeting("World"))

    // 非公開関数は同じパッケージ内から呼べます。
    greet("Go")
}

Goのパッケージシステムはシンプルかつ厳格です。未使用のインポートはコンパイルエラーになるため、常にコードが整理された状態を保てます。インポートパスはモジュール名から始まるフルパスで書きます（例: 『"github.com/user/repo/pkg"』）。

パッケージ名は通常ディレクトリ名と一致させますが、必須ではありません。慣習として短くシンプルな名前（小文字、アンダースコアなし）を使います。

ドットインポート（import . "pkg"）はパッケージ名が省略できて便利ですが、どのパッケージの識別子かわかりにくくなるため、通常のコードでは使わないことを推奨します。

モジュールの依存管理は『Go Modules』を、よく使うGoコマンドは『go build / run / test』を参照してください。