できない.dev

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

go install したコマンドが command not found なら、インストール先の bin を PATH に追加すれば直る。
置き場所(既定は $HOME/go/bin など)は go env GOPATH GOBIN で確かめる。

公開: 更新:

症状できない · exit 127
hello
sh: 1: /recipe.sh: hello: not found
解決後できた · exit 0
hello
hello from the installed binary

2026-09-25 に golang:1.23(Go 1.23.12) で実際に打って取った出力。検証環境の詳細

要約

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
$ echo $?
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
$ echo $?
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
$ echo $?
127
$ export PATH=$PATH:$HOME/bin
$ command -v hello
/root/bin/hello
$ hello
hello from the installed binary
$ echo $?
0

— 2026-09-25 時点の出力

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

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

解決策

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 したコマンドがどこからでも実行できる。

よくある原因

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