できない.dev

Go「declared and not used」の原因と直し方

Go の declared and not used は、宣言したローカル変数を一度も使わないと出るコンパイルエラーだ。
不要な変数は削除し、残すなら _ に代入すれば直る。
未使用の import も同じ規則でエラーになる。

公開: 更新:

症状できない · exit 1
go build ./...
# example.com/unused
./main.go:5:2: "os" imported and not used
./main.go:9:2: declared and not used: x
解決後できた · exit 0
go build ./...

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

要約

Go では、関数内で宣言したローカル変数を一度も使わないと declared and not used でコンパイルが止まる。
これは警告ではなくエラーで、ビルド自体が通らない。
使わない変数は削除するのが基本で、どうしても残したいときはブランク識別子 _ に代入して「意図的に捨てている」ことをコンパイラに伝える。

./main.go:6:2: declared and not used: x

実行例

golang:1.23 のコンテナで、未使用の import と未使用のローカル変数を両方含むコードをビルドすると、"os" imported and not used と declared and not used: x が別々の行として同時に報告された。
どちらもコンパイルを止める。
import を削り、変数をブランク識別子へ代入し直すと、同じ go build ./... が終了コード 0 で通った。

$ go build ./...
# example.com/unused
./main.go:5:2: "os" imported and not used
./main.go:9:2: declared and not used: x
$ echo $?
1
$ go build ./...
$ echo $?
0
$ go run .
hello
$ go run .
123

— 2026-08-28 時点の出力

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

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

解決策

1. 使わない変数は削除する

最も素直な対処だ。
エディタの Go 拡張(gopls)が未使用変数をハイライトしてくれるので、それを消す。

2. ブランク識別子 _ に代入する

戻り値の一部だけ必要なときは、不要な値を _ で受ける。

v, _ := strconv.Atoi(s) // err は使わないので _ で破棄
fmt.Println(v)

一時的に変数を残したい(あとで使う予定)場合も、明示的に捨てられる。

x := compute()
_ = x // いまは使わないが意図的に保持

ただし _ = x を多用するのは設計の臭いなので、本当に必要か見直すきっかけにする。

3. 未使用 import は自動整形で消す

未使用の import は手で消してもよいが、goimports を使うと未使用の削除と不足の追加をまとめて行える。

go install golang.org/x/tools/cmd/goimports@latest
goimports -w .

VS Code の Go 拡張なら保存時に自動実行されるよう設定できる。
これらの実装制限は Go 言語仕様(新しいタブで開く) の宣言に関する節に「コンパイラは未使用のローカル変数の宣言を不正にしてよい」と明記されている。

よくある原因

  1. 変数を消し忘れている。
    デバッグ中に作った変数や、途中まで書いて使わなくなった変数が残っている。
  2. := で作ったまま読み出していない。
    x := compute() のように代入はしたが、その後 x を参照していない。
    代入しただけでは「使った」ことにならない。
  3. 複数戻り値の一部を受けたまま使っていない。
    v, err := f() の v を使わずに放置している。
  4. 未使用の import がある。
    変数と同じ規則で、import したパッケージを使っていないと imported and not used になる。

この規則はローカル変数に限られ、パッケージレベルの変数は未使用でもエラーにならない。