yagibrary
← 記事一覧に戻る
公開日: 2026-06-14

WindowsでGo環境構築時に「コマンドが見つからない」となった時の対処法（PATH設定からgodoc、Hello World実行まで）

Go Windows 環境構築 初心者向け

Windows環境でGoの学習を始める際、「Goをインストールしたはずなのにターミナルで go や godoc コマンドが動かない」というトラブルに遭遇することがあります。環境変数（Path）の設定方法から、godocのセットアップ、最初のプログラム実行までをわかりやすく解説します。

Windows環境でGoの学習を始める際、「Goをインストールしたはずなのにターミナルで go や godoc コマンドが動かない」というトラブルに遭遇することがあります。

本記事では、WindowsにおけるGo環境構築の落とし穴である環境変数（PATH）の設定方法から、ドキュメントツールであるgodoc のセットアップ、最初のプログラムを動かすHello Worldの実行までを網羅して解説します。

💻 よくあるトラブル：コマンドが動かない原因

Goのインストーラー（MSI）を使ってインストールした場合、通常は自動的に環境変数が設定されますが、いくつかの要因でコマンドが認識されないエラー（CommandNotFoundException）が発生します。

go : The term 'go' is not recognized as the name of a cmdlet, function, script file, or operable program.

主な原因

  • インストール後にターミナル（PowerShell やコマンドプロンプト）を再起動していない。
  • 環境変数 Path にGoの実行フォルダが登録されていない。

Goのデフォルトのインストール先は C:\Program Files\Go です。この中にある C:\Program Files\Go\bin に go.exe が格納されています。ここにパスが通っている必要があります。

💡 解決の鍵：環境変数（PATH）の登録と反映

① 一時的に現在のターミナルに反映する（動作確認用）

現在のターミナルセッションでのみ一時的にパスを通したい場合は、PowerShellで以下を実行します。

$env:Path += ";C:\Program Files\Go\bin;C:\Users\user\go\bin"

② 永続的にシステムへ登録する（推奨）

今後新しく開くすべてのターミナルで有効にするため、ユーザー環境変数 Path に以下の2つのパスを永続的に追加します。

  1. C:\Program Files\Go\bin （Go本体）
  2. C:\Users\user\go\bin （go install で追加されるツールの格納先）

PowerShellから管理者権限なしで永続追加するには、以下のコマンドを実行します。

[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::User) + ";C:\Program Files\Go\bin;C:\Users\user\go\bin", [EnvironmentVariableTarget]::User)

③ 開いているターミナルに設定を即時反映する

環境変数を永続追加した場合、通常はターミナルを再起動する必要がありますが、以下のコマンドを実行することで開き直さずに即座に反映させることができます。

$env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")

設定が完了したら、以下のコマンドで動作確認を行います。

go version

go version go1.26.4 windows/amd64 のようにバージョン情報が表示されれば成功です。

🚀 ドキュメントツール「godoc」のセットアップと使い方

Go 1.12以降、ドキュメント閲覧用ツールである godoc は標準のGo配布物から分離されました。そのため、手動でインストールする必要があります。

① インストール方法

ターミナルで以下のコマンドを実行し、最新の godoc をインストールします。

go install golang.org/x/tools/cmd/godoc@latest

※インストールされた実行ファイルは C:\Users\user\go\bin\godoc.exe に保存されます。

② 使い方（go doc と godoc の違い）

Goにはドキュメントを参照する方法が2通りあります。用途に合わせて使い分けましょう。

A. コマンドラインで素早く確認したい場合（go doc）

ターミナル上でテキストとしてドキュメントを表示します。標準機能なので追加インストールは不要です。

go doc fmt
go doc fmt Println

B. ブラウザのGUIでリッチに閲覧したい場合（godoc）

ローカルWebサーバーを起動し、公式ドキュメント（pkg.go.dev）と同様のUIでドキュメントを参照できます。

godoc -http=localhost:6060

実行後、Webブラウザで http://localhost:6060 にアクセスすると、ローカル環境や標準パッケージのドキュメントをブラウズできます。

🛠️ 最初のプログラム（Hello World）を実行する

環境構築が完了したら、実際にGoのプログラムを動かしてみましょう。

① ソースファイルの作成

適当なディレクトリに lesson.go という名前でファイルを作成し、以下のコードを記述します。

package main

import "fmt"

func main() {
    fmt.Println("Hello, World!")
}

注意点：Goでは、実行可能なプログラムを作成する際、必ずパッケージ名を main にし、エントリーポイントとなる func main() 関数を定義する必要があります。package main だけの空ファイルを実行しようとすると、以下のエラーが発生します。 runtime.main_main·f: function main is undeclared in the main package

② プログラムの実行

ソースファイルがあるディレクトリで、以下のコマンドを実行します。

go run lesson.go

ターミナルに以下のように出力されれば、無事にGoの実行環境の構築が完了です！

Hello, World!

🎯 Go言語の基礎から応用まで学べるおすすめ教材

Goの環境構築が完了し、最初の Hello World を実行した後は、本格的なプログラムの開発に進みましょう。

基礎的な文法から、実際のWeb開発や高度な金融アプリケーション開発まで体系的に学べるおすすめのUdemy講座をご紹介します。

現役シリコンバレーエンジニアが教えるGo入門 + 応用でビットコインのシストレFintechアプリの開発

Goの基礎文法を網羅した入門パートから、後半では実際にビットコインの自動取引を行うFintechアプリケーションの構築を行う、非常に実践的で評価の高いベストセラー講座です。シリコンバレーの現役エンジニアによる本質的な解説で、現場で通用するGoの書き方が身につきます。

オンライン動画教材（Udemy）

現役シリコンバレーエンジニアが教えるGo入門 + 応用でビットコインのシストレFintechアプリの開発

基礎的なGoの文法を徹底的に叩き込んだ上で、応用としてビットコインの自動システムトレードを行うFintechアプリを開発する、Go学習の決定版とも言える講座です。

udemy.com • 講座の詳細を見る →

📝 まとめ：つまずいた時のチェックリスト

WindowsでGoの環境構築につまずいた際は、以下の3点を確認しましょう。

  1. C:\Program Files\Go\bin と C:\Users\user\go\bin が Path に入っているか
  2. 環境変数を追加した後に、ターミナルを再起動するか環境変数を再読み込みしたか
  3. 実行するGoファイルに main パッケージと main() 関数が定義されているか

快適なGo開発ライフをスタートさせてください！

この記事をシェアする