アクセス制御

Goには、パッケージ内で定義した関数や型を、パッケージの外から呼び出せるようにするか/内部でだけ使えるようにするかを制御する仕組みがあります。ここでは、その仕組みを実際にコードで確認していきます。

1. 呼び出しの制御

Goでは、識別子の先頭文字が大文字か小文字か によって、パッケージの外から呼び出せるかどうかが決まります。大文字始まりの識別子は エクスポート されてパッケージ外から参照でき、小文字始まりの識別子は 非エクスポート となり、そのパッケージの中でしか使えません。書き方は以下のとおりです。

// 大文字始まり → エクスポート(他パッケージから参照可)
func Xxx() { ... }

// 小文字始まり → 非エクスポート(パッケージ内でのみ参照可)
func xxx() { ... }

以降、エクスポート識別子・非エクスポート識別子の順に、実際にコードで挙動を確認していきます。

2. エクスポート識別子

先の ## パッケージの分割 で、calculator.Add を main.go から呼び出せることは確認しました。ここでは新しく大文字始まりの Subtract 関数を追加して、同じようにエクスポート識別子として外から呼び出せることを試してみます。

calculator/calculator.go に Subtract 関数を追加して、以下の内容に書き換えます。

package calculator

func Add(a, b int) int {
    return a + b
}

// 大文字始まり → エクスポート(外から呼び出せる)
func Subtract(a, b int) int {
    return a - b
}

main.go を Subtract を呼び出すコードに書き換えます。

package main

import (
    "fmt"

    "github.com/example/myapp/calculator"
)

func main() {
    fmt.Println(calculator.Subtract(10, 3))
}

実行すると以下のような結果が表示されます。

7

Subtract は大文字始まりでエクスポートされているため、calculator パッケージの外にある main.go からも calculator.Subtract(...) の形で参照でき、呼び出しが成功します。これがエクスポート識別子の実例です。

動作確認が終わったら、calculator.go の Subtract 関数と main.go の該当行は削除して元の状態に戻しておきます。

3. 非エクスポート識別子

小文字始まりの識別子は、同一パッケージ内からは自由に使えます が、パッケージの外からは呼び出せません。実際に両方の挙動を試してみます。

3.1 検証用コードの準備

calculator/calculator.go に、小文字始まりの multiply 関数と、それを内部で呼び出すエクスポート関数 Square を追加して、以下のように書き換えます。

package calculator

func Add(a, b int) int {
    return a + b
}

// 小文字始まり → 非エクスポート
func multiply(a, b int) int {
    return a * b
}

// エクスポート関数 → 同一パッケージ内なので multiply を呼び出せる
func Square(n int) int {
    return multiply(n, n)
}

Square は同じ calculator パッケージ内にあるため、非エクスポートの multiply を問題なく呼び出せる形になっています。この状態で、パッケージ内からの呼び出しとパッケージ外からの呼び出しを、それぞれ試していきます。

3.2 パッケージ内からの呼び出し

まず、main.go から Square を呼び出して、Square の中から multiply が呼び出せていることを確認します。

package main

import (
    "fmt"

    "github.com/example/myapp/calculator"
)

func main() {
    fmt.Println(calculator.Square(4))
}

実行すると以下のような結果が表示されます。

16

Square(4) は内部で multiply(4, 4) を呼び、その結果 16 が返っています。非エクスポートの multiply も、同じパッケージ内から(calculator/calculator.go の Square から)は問題なく呼び出せていることが分かります。

3.3 パッケージ外からの呼び出し

次に、main.go を書き換えて、multiply を パッケージ外から直接 呼び出そうとしてみます。

package main

import (
    "fmt"

    "github.com/example/myapp/calculator"
)

func main() {
    fmt.Println(calculator.multiply(3, 5))
}

この状態で実行しようとすると、以下のようなコンパイルエラーが表示されます。

./main.go:10:28: name multiply not exported by package calculator

multiply は非エクスポート識別子(not exported)として、calculator パッケージの外にある main.go からは参照できずコンパイルが通りません。

まとめると、multiply は calculator パッケージ内からは呼び出せる(Square 経由で確認)ものの、パッケージ外の main.go からは呼び出せない(コンパイルエラー)ということが実際のコードで確認できました。

動作確認が終わったら、calculator.go の multiply / Square 関数と、main.go の該当行はどちらも削除して元の状態に戻しておきます。

4. 適用範囲

エクスポート/非エクスポートのルールは関数だけでなく、変数・定数・構造体の型・構造体のフィールド など、Go の識別子全般に同じように適用されます。それぞれ、書き方を対比で見ていきます。

4.1 変数

パッケージレベルで宣言する変数も同じルールに従います。

// 大文字始まり → エクスポート
var Xxx = ...

// 小文字始まり → 非エクスポート
var xxx = ...

4.2 定数

const で宣言する定数も同様です。

// 大文字始まり → エクスポート
const Xxx = ...

// 小文字始まり → 非エクスポート
const xxx = ...

4.3 構造体の型

構造体の型定義も、型名の先頭文字でエクスポート/非エクスポートが決まります。

// 大文字始まり → エクスポート
type Xxx struct{ ... }

// 小文字始まり → 非エクスポート
type xxx struct{ ... }

4.4 構造体のフィールド

構造体のフィールドは、フィールド名の先頭文字で フィールドごと にエクスポート範囲が決まります。

type User struct {
    Name string  // 大文字 → エクスポート(他パッケージから u.Name で参照可)
    age  int     // 小文字 → 非エクスポート(同一パッケージ内でのみ参照可)
}

この User 型を他のパッケージから使うと、u.Name は参照できますが、u.age は先ほどの multiply と同じ理由でコンパイルエラーになります。構造体を設計するときは、外部に触ってほしいフィールドだけを大文字始まりにする、という書き分けが基本になります。

命名だけでエクスポート範囲が決まるため、public / private などのアクセス修飾子キーワードは Go に存在しません。「外に見せるものは大文字始まりで書く」という命名規約1つでアクセス制御ができる、シンプルな設計になっています。