go install したコマンドが「command not found」で実行できない

要約

go install example.com/cmd/tool@latest が成功しても tool が command not found になるのは、インストール先のディレクトリが PATH に入っていないためです。

go install はビルドしたバイナリを GOBIN（既定では $GOPATH/bin、GOPATH 未設定なら $HOME/go/bin）へ置きます。
まずその場所を確認します。

実行例

公式イメージ golang:1.23 で go install . は成功するのに hello は not found（終了コード 127）になり、実行ファイルは go env GOPATH が示す /go の bin に置かれていたので、そこを PATH に足すと動いた。
続けて /go/bin の hello を消し、GOBIN を $HOME/bin に変えて入れ直すと置き場所は /root/bin に移り、PATH に足すまでは再び終了コード 127、足した後は command -v hello が /root/bin/hello を指して実行できている。

$ go install .

$ hello
sh: 1: /recipe.sh: hello: not found
終了コード: 127

$ go env GOPATH GOBIN
/go

$ ls "$(go env GOPATH)/bin"
hello

$ echo $PATH
/usr/local/go/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin

$ export PATH=$PATH:$(go env GOPATH)/bin

$ hello
hello from the installed binary
終了コード: 0

$ rm "$(go env GOPATH)/bin/hello"

$ go env -w GOBIN=$HOME/bin

$ go install .

$ go env GOPATH GOBIN
/go
/root/bin

$ ls "$(go env GOBIN)"
hello

$ hello
sh: 1: /recipe.sh: hello: not found
終了コード: 127

$ export PATH=$PATH:$HOME/bin

$ command -v hello
/root/bin/hello

$ hello
hello from the installed binary
終了コード: 0

— 2026-09-25 時点の出力

よくある原因

1. bin が PATH に無い: $(go env GOPATH)/bin が PATH に含まれていない。
2. GOBIN の変更: GOBIN を独自に設定したが、その場所を PATH に追加していない。
3. GOPATH 未設定: 既定の $HOME/go/bin に置かれていることを見落としている。
4. 再読み込み漏れ: 設定ファイルに追記したのにシェルへ反映していない。

解決策

1. インストール先を確認する

まず実際の置き場所を調べます。

go env GOPATH GOBIN

GOBIN が空なら $GOPATH/bin（多くは $HOME/go/bin）が置き場所です。

2. PATH に追加する

シェルの設定ファイルへ追記します。

echo 'export PATH=$PATH:$(go env GOPATH)/bin' >> ~/.zshrc
source ~/.zshrc

3. GOBIN を使う場合

置き場所を固定したいときは GOBIN を設定し、その場所も PATH に通します。

go env -w GOBIN=$HOME/bin
export PATH=$PATH:$HOME/bin

設定後にシェルを開き直すと、go install したコマンドがどこからでも実行できます。