できない.dev

Go の go run でパッケージが実行できない(package is not a main package)

go run は package main で func main() を持つパッケージしか実行できない。
ライブラリ側のディレクトリを指定したり、package foo のままだとこのエラーになる。

公開: 更新:

症状できない · exit 1
go run .
package example.com/myapp is not a main package
解決後できた · exit 0
go build ./...

2026-08-27 に golang:1.23(Python 3.11.2 / Git 2.39.5) で実際に打って取った出力。検証環境の詳細

要約

go run に渡したパッケージが package main でない、もしくは func main() を持っていないとこのエラーになる。
ライブラリ用パッケージは go run の対象にできない。
実行用エントリは必ず package main と func main() を持つ別ディレクトリ(例: cmd/myapp)に置く。

// cmd/myapp/main.go
package main
 
func main() {
    // ...
}

実行例

golang:1.23 で動かすと、ライブラリのまま go run . を叩いた時点で package example.com/myapp is not a main package が出て、終了コード 1 で止まった。
同じコードでも go build ./... は終了コード 0 で通った。
エントリを cmd/myapp の main パッケージへ分けた go run ./cmd/myapp は、hello from library を表示した。

$ go run .
package example.com/myapp is not a main package
$ echo $?
1
$ go build ./...
$ echo $?
0
$ go run ./cmd/myapp
hello from library
$ echo $?
0

— 2026-08-27 時点の出力

検証環境Python 3.11.2 / Git 2.39.5 / 2026-08-27 検証
検証日
実行環境
golang:1.23 Debian GNU/Linux 12 (bookworm)
バージョン
  • Python 3.11.2
  • Git 2.39.5

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. エントリポイントを cmd/ 配下に分離する

Go の慣習レイアウト(新しいタブで開く)では、ライブラリ本体はモジュールルート直下、CLI エントリは cmd/<name>/main.go に置く。

myapp/
├── go.mod
├── foo.go            // package myapp(ライブラリ)
└── cmd/
    └── myapp/
        └── main.go   // package main + func main()

実行は次の通り。

go run ./cmd/myapp

2. ファイル単体実行する場合

go run main.go helper.go

main パッケージ内のすべての .go ファイルを並べる。
ディレクトリ指定 (go run ./cmd/myapp) の方が漏れがなく安全だ。

3. 「ビルドはできるが run できない」場合

ライブラリは go build ./... で型チェックは通るが、go run は通らない。
CLI として動かしたいなら、必ず main パッケージに分離する。

よくある原因

  1. ライブラリ用のディレクトリで、package main の宣言が無い package foo のまま go run . を叩いた。
    Go はライブラリパッケージを直接実行する手段を持たない。
  2. func main() が欠けている。
    宣言は package main でも本体関数が無いと、別バリエーションのエラー(function main is undeclared 等)になる。
  3. ディレクトリの指定が違う。
    モジュールルートで go run . を叩いたが、エントリは cmd/myapp/ 配下に置いていた。
  4. ファイル単体を指定していて、関連ファイルが足りない。
    go run main.go だけを叩いても、main から呼ぶ関数が別ファイルにあるなら、それらも引数に並べる必要がある。