Go言語プログラムの実行方法まとめ!VSCode・ターミナルでの実行手順を解説
生徒
「Go言語でプログラムを書いたあとって、どうやって実行すればいいんですか?」
先生
「Go言語のプログラムを実行するには、ターミナルという黒い画面を使う方法と、Visual Studio Code(VSCode)という開発用のソフトを使う方法があります。」
生徒
「ターミナルってなんだか難しそうです……。VSCodeってどんなものなんですか?」
先生
「心配しなくても大丈夫ですよ!ターミナルもVSCodeも、使い方さえ覚えれば簡単です。それでは順番に、Go言語のプログラムをどうやって実行するのか、丁寧に説明していきましょう。」
1. Go言語プログラムを実行するために必要な準備
Go言語のプログラムを実行するには、まず公式サイトからGo本体をインストールします。Windows/macOSはインストーラを実行、Linuxはパッケージまたは配布アーカイブを導入します。インストール後、ターミナルを開いて動作確認しましょう。
インストール確認(バージョン表示)
go version
上のコマンドで「go version go1.xx…」のように表示されれば準備OKです。表示されない場合は、インストールが完了していないか、PATH(Goの場所を教える設定)が通っていない可能性があります。いったんターミナルを閉じて開き直す、PCを再起動する、またはインストール手順を見直してください。
作業フォルダも先に用意しておくとスムーズです。たとえばデスクトップにgo-practiceというフォルダを作って、今後はそこを「練習場所」として使います。
次に、プログラムを書くアプリ(エディタ)としてVisual Studio Code(VSCode)を用意します。VSCodeを起動したら、左の拡張機能から「Go」と検索し、Go拡張機能(Go Team at Google)をインストールします。初回は推奨ツールの導入を求められるので、そのまま「Install」しておくと補完やエラー表示が賢くなり、初心者でも書きやすくなります。
ここまでできれば「Goのインストール確認」「VSCode+Go拡張の導入」「作業フォルダの準備」が整いました。次の章では、この環境を使って実際にGoプログラムを実行していきます。
2. ターミナルでGoプログラムを実行する手順
ターミナルは、コマンド(命令)を文字で入力して操作するアプリです。最初はとっつきにくく見えますが、やることは「場所へ移動して、実行する」だけ。手順どおりに進めれば迷いません。
- 作業フォルダを用意する(例:デスクトップに練習用フォルダ)
mkdir go-practice
cd デスクトップ/go-practice
場所が合っているか不安なら「今どこにいるか」を確認します。
pwd (現在の場所を表示)
ls (macOS/Linuxのファイル一覧)/dir(Windows)
- プログラムファイルを作る(名前は
main.go)
package main
import "fmt"
func main() {
fmt.Println("こんにちは、Go言語!")
}
- 実行する(ファイル名を指定)
go run main.go
次のように表示されれば成功です。
こんにちは、Go言語!
フォルダの中に main.go だけがある場合は、フォルダ単位でも実行できます。
go run .
実行できないときは、cdで正しい場所にいるか、main.goという拡張子になっているかをまず確認しましょう。ここまで覚えれば、ターミナルからの基本的な実行はマスターです。
3. VSCodeでGoプログラムを実行する方法
VSCode(Visual Studio Code)は無料で使えるコードエディタです。Go拡張を入れると、補完・エラー表示・実行ボタンが使えるようになり、初心者でもつまずきにくくなります。
準備: 左の拡張機能(四角いアイコン)で「Go」を検索し、Go拡張機能をインストール。初回は追加ツールの導入を求められるので、そのまま「Install」を選べばOKです。
実行までの流れ: フォルダを作ってVSCodeで開き、main.goを作成して保存します(フォルダを開いてからファイルを作るのがコツ)。
- メニューのファイル → フォルダーを開くから練習用フォルダを開く
- 新しいファイルで
main.goを作成し、次のサンプルを貼り付ける
package main
import "fmt"
func main() {
fmt.Println("VSCodeからGoを実行!")
}
保存すると、main関数の上に「Run」や「Debug」の小さなボタン(コードレンズ)が表示されることがあります。Runをクリックすると、そのまま実行できます。ボタンが出ない場合は、VSCode内でターミナルを開いてコマンドで実行しましょう。
ターミナルを使う場合: メニューのターミナル → 新しいターミナルを選び、次を入力します。
go run main.go
問題なく動けば、下部のターミナルに次の表示が出ます。
VSCodeからGoを実行!
フォルダ内に実行したいファイルだけがあるなら、フォルダ単位での実行も簡単です。
go run .
うまくいかないときは、ファイルを保存しているか、拡張子が.goになっているか、VSCodeでフォルダごと開けているかを確認しましょう。これだけでVSCodeからの基本的な実行は身につきます。
4. よくあるエラーとその対処法
はじめての実行でつまずきやすいポイントと、迷わず直すコツをまとめます。症状→原因→確認手順→最小の修正、の順にチェックすると復旧が早くなります。
● 「'go' は内部コマンド…/command not found」
Goが未インストール、またはPATH設定が未反映です。まずターミナルを開き直し、次を試します。
go version
バージョンが出なければ、インストールのやり直しや再起動、PATH設定の再確認を行います。
● 実行場所が違う(ファイルが見つからない)
main.goのあるフォルダにいない場合に起きます。現在地と中身を確認してから移動します。
pwd (今いる場所)
ls / dir (ファイル一覧)
cd フォルダ名
● 拡張子やファイル名のミス
.goで保存していない、全角文字やスペースを含む名前にしている、などで失敗します。エクスプローラー/Finderで拡張子を確認し、main.goに修正しましょう。
● package main / main関数がない
実行可能な最小形は次のとおりです。迷ったら書き直して確認します。
package main
import "fmt"
func main() {
fmt.Println("こんにちは、Go言語!")
}
● インポート漏れ・タイプミス
fmtを使うのにimport "fmt"がない、PrintlnをPrintnと誤記、全角の引用符を使っている等が原因です。以下の「誤り例→修正例」を見比べて直しましょう。
// 誤り例
package main
func main() {
Printn(“Hello”) // importなし/関数名ミス/全角の引用符
}
// 修正例
package main
import "fmt"
func main() {
fmt.Println("Hello")
}
● フォルダ単位の実行で混乱する
フォルダ内に複数のmainパッケージがあるとgo run .で失敗します。最初はファイルを指定して実行するのが確実です。
go run main.go (まずはこれで確認)
上から順にチェックすれば、原因を切り分けやすくなります。特に「場所」「拡張子」「インポート」の3点を見直すと、多くのGo実行エラーはその場で解決できます。
5. 実行方法の違いと選び方
go runは「手早く動作を確かめる」ためのコマンドで、学習や小さなスクリプトに最適です。ソースをその場でコンパイルして実行まで行うため、ファイル1~2枚の練習にはこれだけで十分です。
一方で、配布したい・起動を速くしたい・外部のPCで動かしたい場合はgo buildで実行ファイルを作ります。使い分けの目安は「今だけ動けばいい→go run」「後で繰り返し起動→go build」です。
● まずは素早く試す(go run)
go run main.go # 単一ファイル
go run . # フォルダ内のmainパッケージをまとめて実行
● 配布や繰り返し実行に(go build)
go build -o hello # カレントフォルダをビルドして実行ファイル生成
./hello # macOS / Linux の起動例
hello.exe # Windows の起動例
どちらの方法でも、ターミナル操作が不安ならVSCode内のターミナル → 新しいターミナルを使うと画面移動が少なく、手順を落ち着いて確認できます。まずはgo runで挙動を確認し、必要になったらgo buildで実行ファイルを作る、という流れが無理なく身につきます。
生徒
「先生、結局ぼくは go run と go build、どっちを使えばいいんですか?」
先生
「最初は断然 go run だね。書いたコードをすぐ動かせるから、練習に一番向いてるよ。」
生徒
「じゃあ go build はいつ使うんですか?」
先生
「作ったアプリを家族や友達のパソコンでも動かしたいとき。.exe みたいな実行ファイルを作れるから、配布したり保管したりしやすいんだ。」
生徒
「なるほど!まずは go run で練習しながら、慣れてきたら go build も試してみます!」
まとめ
ここまで、Go言語のプログラムを実行するために必要な準備、ターミナルでの実行方法、VSCodeを使った実行手順、そして初心者がつまずきやすいエラーについて順番に解説してきました。初めてGo言語に触れる方でも、プログラムを書いて動かすまでの流れを一歩ずつ理解できるように、できるだけ専門用語を使わずに説明しました。プログラミングは「難しそう」「黒い画面がこわい」というイメージを持たれがちですが、実際には決まった手順をゆっくり確認していけば、初心者でもしっかり動かすことができます。
特に大切なのは、プログラムを書いたあとに、実際に実行してみることです。書いたコードが動く瞬間は、プログラミングを学ぶうえで最初の大きな感動になります。ターミナルでの操作も、VSCodeでの操作も、最初は見慣れないかもしれませんが、使っていくうちに「入力して実行するだけ」というシンプルな流れがわかってきます。Go言語は動作がとても早く、実行したらすぐ画面に結果が表示されるため、学習にも向いている言語です。
また、「go run」と「go build」の違いも軽く触れましたが、初心者はまず「go run」で問題ありません。これは作ったプログラムを直接実行する方法で、確認しながら学びたい人に向いています。一方で、プログラムを配布したり、誰かに渡して動かしてもらいたい場合は「go build」で実行ファイルを作る方法もあります。とはいえ、いきなり難しいことに挑戦する必要はないので、まずはターミナルとVSCodeで好きなメッセージを表示させるところから始めると良いでしょう。
最後に、簡単なサンプルをもう一度書いておきます。もし動かなかった場合でも、先ほど紹介したエラー例を見直すことで原因がわかることが多いので、あせらず確認してみてください。
package main
import "fmt"
func main() {
fmt.Println("Go言語の基本を学習中!")
}
プログラムが書けたら、ターミナルで次のコマンドを入力します。
go run main.go
無事にプログラムが動けば、画面に文字が表示されます。ほんの少しのコードでも、自分が書いた命令がパソコンの画面に出るのは大きな達成感につながります。小さな成功を積み重ねていくと、プログラミングが楽しくなり、自分の作りたいアプリやサービスを形にできるようになります。
もし、プログラムがうまく動かなくても心配はいりません。プログラミングはトライアンドエラーを繰り返しながら学んでいくものです。エラーが出たということは、パソコンが「ここを直せば動くよ」と教えてくれている状態です。ひとつずつ直していくことで、自然と理解が深まり、自信もついていきます。特にGo言語はエラーの内容が比較的やさしく表示されるので、初心者でも原因を見つけやすいのが特徴です。
VSCodeを使った方法も紹介しましたが、VSCodeは今後プログラミングを続けていくうえで非常に便利なツールです。ファイルを書いて保存するだけでなく、コードの色分けやエラー表示、ファイル管理、Gitなどの開発ツールとも連携できます。Go言語の拡張機能を入れることで、自動補完や構文のチェックもできるようになり、書き間違いを減らせます。最初はシンプルな使い方だけで十分ですが、慣れてきたら少しずつ便利な機能も活用してみてください。
今回の内容をまとめると、Go言語のプログラムは以下の流れで実行できます。
- Goをインストールする
- テキストエディタ(VSCode)を用意する
- main.goファイルを作りプログラムを書く
- ターミナルやVSCodeのターミナルで「go run main.go」を実行する
- 画面に表示された結果を確認する
これさえできれば「プログラムを動かせる人」です。プログラムを動かせるようになった時点で、すでに初心者を一歩抜け出しています。ここからは少しずつコードを書く練習をしたり、自分の好きなメッセージを表示させたりと、楽しい部分が広がっていきます。
まだ不安なところが残っていても大丈夫です。今回の内容は、何度読み返しても使える基本です。特にターミナルの操作や、VSCodeの使い方は、繰り返して使うことで手が覚えていきます。焦らず、ゆっくり進めていきましょう。
生徒
「最初は難しく感じましたが、ターミナルで実行する方法と、VSCodeで実行する方法、どちらも仕組みがわかってきました!」
先生
「そうですね。どちらも基本は『main.goを作って、go runで実行する』という流れです。できるようになったということは、もう立派にプログラムを動かせていますよ。」
生徒
「VSCodeでターミナルを開けるのは便利でした!画面を切り替えなくて済むので、作業がしやすかったです。」
先生
「その通りです。VSCodeは簡単なプログラムから、大規模な開発まで対応できます。Go言語の練習をするにはピッタリの環境なんです。」
生徒
「次は自分でメッセージを変えたり、数字を出力してみたいです!」
先生
「とても良いですね。小さな挑戦を積み重ねていくことで、着実に力がついていきます。今回学んだ実行方法は、これから書くプログラムすべてで使える大切な知識なので、これからも忘れずに活用していきましょう。」
この記事を読んだ人からの質問
プログラミング初心者からのよくある疑問/質問を解決します
Go言語のプログラムを実行する準備として、パソコンにGoをインストールしないといけないのですか
Go言語でプログラムを実行するためには、パソコンにGoをインストールする必要があります。プログラミングを実行するための道具がないとプログラムは動きません。インストールが正しくできていると、ターミナルやVSCodeでGoのコマンドを使えるようになります。
Goをインストールしたのにターミナルでコマンドが認識されないのはなぜですか
Goをインストールしても、パスが設定されていないとターミナルがコマンドを見つけられません。パソコンがGo言語の場所を知らないためです。パスを設定するか、再インストールすると認識されることが多いです。
ターミナルを使うときに黒い画面が怖いのですが使いこなせますか
ターミナルは黒い画面ですが、やっていることは決まった場所に移動して、決まったコマンドを入力するだけです。難しそうに見えますが、慣れるとパソコンの操作が早くなる便利な道具です。
【超入門】ゼロから始めるGo言語プログラミング:最速で「動くアプリ」を作るマンツーマン指導
「プログラミングの仕組み」が根本からわかる。Go言語でバックエンド開発の第一歩を。
本講座を受講することで、単なる文法の暗記ではなく、「プログラムがコンピュータの中でどう動いているか」という本質的な理解につながります。シンプルながら強力なGo言語(Golang)を通じて、現代のバックエンドエンジニアに求められる基礎体力を最短距離で身につけます。
具体的な開発内容と環境
【つくるもの】
ターミナル(黒い画面)上で動作する「対話型計算プログラム」や、データを整理して表示する「ミニ・ツール」をゼロから作成します。自分の書いたコードが形になる感動を体験してください。
【開発環境】
プロの現場でシェアNo.1のVisual Studio Code (VS Code)を使用します。インストールから日本語化、Go言語用の拡張機能設定まで、現場基準の環境を一緒に構築します。
この60分で得られる3つの理解
「なぜ動くのか」という設定の仕組みを理解し、今後の独学で詰まらない土台を作ります。
データの種類やメモリの概念など、他言語にも通じるプログラミングの本質を学びます。
ただ動くだけでなく、誰が見ても分かりやすい「綺麗なコード」を書くための考え方を伝授します。
※本講座は、将来的にバックエンドエンジニアやクラウドインフラに興味がある未経験者のためのエントリー講座です。マンツーマン形式により、あなたの理解度に合わせて進行します。
初めてのGo言語を一緒に学びましょう!