カテゴリ: Go言語 更新日: 2026/01/12

Go言語のgo testコマンドの便利なオプションまとめ!初心者でもわかるテスト実行方法

Go言語のgo testコマンドの便利なオプションまとめ
Go言語のgo testコマンドの便利なオプションまとめ

先生と生徒の会話形式で理解しよう

生徒

「Go言語でテストをするとき、毎回同じコマンドだけじゃ不便なんですが、便利なオプションってありますか?」

先生

「もちろんあります。go testにはテストを効率よく実行できるオプションがたくさんあります。」

生徒

「どんなオプションがあるんですか?」

先生

「それでは、一つずつ初心者でもわかるように説明していきます!」

1. 基本のgo testコマンド

1. 基本のgo testコマンド
1. 基本のgo testコマンド

Go言語では、テストファイルの名前をxxx_test.goにしておくと、go testコマンドで自動的にテストを実行できます。


go test

このコマンドだけで、同じディレクトリ内の全てのテスト関数が実行されます。

2. -vオプションで詳細表示

2. -vオプションで詳細表示
2. -vオプションで詳細表示

-vはverbose(詳細)の意味で、テストの実行状況をすべて表示します。どのテストが通ったか失敗したかがわかりやすくなります。


go test -v

初心者でも、どのテストがどこで失敗したか簡単に確認できます。

3. -runオプションで特定のテストだけ実行

3. -runオプションで特定のテストだけ実行
3. -runオプションで特定のテストだけ実行

テスト関数がたくさんある場合、特定のテストだけを実行したいことがあります。そのときに使えるのが-runです。


go test -run TestAdd

この例では、TestAddという名前のテスト関数だけを実行します。部分的にテストしたいときに便利です。

4. -coverオプションでカバレッジ確認

4. -coverオプションでカバレッジ確認
4. -coverオプションでカバレッジ確認

カバレッジとは、テストがコードのどれだけを確認しているかの割合です。-coverを使うと、テストの網羅性を簡単に確認できます。


go test -cover

出力にパーセント表示がされ、テストがコードの何%をチェックしているかがわかります。

5. -benchオプションでベンチマーク実行

5. -benchオプションでベンチマーク実行
5. -benchオプションでベンチマーク実行

Go言語では、性能測定のためのベンチマークテストもサポートしています。-benchオプションを使うと実行できます。


go test -bench=.

ドット(.)は全てのベンチマークを実行するという意味です。特定の関数だけ測定したいときは、関数名を指定します。

6. -countオプションで繰り返しテスト

6. -countオプションで繰り返しテスト
6. -countオプションで繰り返しテスト

一部のバグは一度のテストでは発生しないことがあります。-countを使うと、テストを複数回繰り返して実行できます。


go test -count=5

この例では、同じテストを5回繰り返し実行します。再現性の確認に便利です。

7. -timeoutオプションでテストの制限時間を設定

7. -timeoutオプションでテストの制限時間を設定
7. -timeoutオプションでテストの制限時間を設定

無限ループなどでテストが止まらない場合に、-timeoutを設定して自動的に終了させることができます。


go test -timeout 10s

この例では10秒以内にテストが終わらなければタイムアウトします。安全にテストを実行できます。

8. 複数オプションを組み合わせて効率化

8. 複数オプションを組み合わせて効率化
8. 複数オプションを組み合わせて効率化

オプションは組み合わせて使うこともできます。例えば、詳細表示とカバレッジ確認を同時に行う場合は次のようにします。


go test -v -cover

テストの結果を詳細に確認しつつ、どれだけコードがカバーされているかも確認できるので便利です。

Go言語を基礎からスッキリ学びたい人や、 文法だけでなく「実用的な使い方」まで押さえたい人には、 定番の入門書がこちらです。

基礎からわかるGo言語をAmazonで見る

※ Amazon広告リンク

9. 初心者でも覚えておきたいポイント

9. 初心者でも覚えておきたいポイント
9. 初心者でも覚えておきたいポイント
  • まずはgo testで全てのテストを実行してみる
  • 詳細が知りたい場合は-vを追加
  • 特定のテストだけ実行する場合は-run
  • テストの網羅性を確認するなら-cover
  • ベンチマークや繰り返しテストも活用してテスト品質を向上
  • タイムアウト設定で安全にテスト

これらを使いこなせば、Go言語のテスト作業がぐっと効率化されます。

関連セミナーのご案内

【超入門】ゼロから始めるGo言語プログラミング:最速で「動くアプリ」を作るマンツーマン指導

「プログラミングの仕組み」が根本からわかる。Go言語でバックエンド開発の第一歩を。

本講座を受講することで、単なる文法の暗記ではなく、「プログラムがコンピュータの中でどう動いているか」という本質的な理解につながります。シンプルながら強力なGo言語(Golang)を通じて、現代のバックエンドエンジニアに求められる基礎体力を最短距離で身につけます。

具体的な開発内容と環境

【つくるもの】
ターミナル(黒い画面)上で動作する「対話型計算プログラム」や、データを整理して表示する「ミニ・ツール」をゼロから作成します。自分の書いたコードが形になる感動を体験してください。

【開発環境】
プロの現場でシェアNo.1のVisual Studio Code (VS Code)を使用します。インストールから日本語化、Go言語用の拡張機能設定まで、現場基準の環境を一緒に構築します。

この60分で得られる3つの理解

1. 環境構築の完全な理解

「なぜ動くのか」という設定の仕組みを理解し、今後の独学で詰まらない土台を作ります。

2. Go言語の基本構造(変数・型)

データの種類やメモリの概念など、他言語にも通じるプログラミングの本質を学びます。

3. 読みやすいコードの書き方

ただ動くだけでなく、誰が見ても分かりやすい「綺麗なコード」を書くための考え方を伝授します。

※本講座は、将来的にバックエンドエンジニアクラウドインフラに興味がある未経験者のためのエントリー講座です。マンツーマン形式により、あなたの理解度に合わせて進行します。

セミナー画像

初めてのGo言語を一緒に学びましょう!

カテゴリの一覧へ
新着記事
New1
Go言語
Go言語のスコープとは?ローカル変数・グローバル変数の違いと使い分け
New2
Go言語
Go言語の構文ルールまとめ!インデント・セミコロンなど最初に知っておくポイント
New3
Kotlin
KotlinのwithTimeoutでタイムアウト処理を設定しよう!初心者にもわかる非同期の安全な止め方
New4
Go言語
Go言語のマップの順序保証がない理由と扱い方の工夫をやさしく解説!初心者でもわかる基本知識
人気記事
No.1
Java&Spring記事人気No1
Swift
Swift Playgroundの使い方を完全解説!初心者に最適な学習環境の始め方
No.2
Java&Spring記事人気No2
Kotlin
Kotlinのsettings.gradleファイルを完全解説!初心者でもわかるプロジェクト設定の基本
No.3
Java&Spring記事人気No3
Go言語
Go言語でREST APIを作る設計と実装パターン完全ガイド!初心者でもわかるAPI開発
No.4
Java&Spring記事人気No4
Kotlin
Android Studioのインストール手順と初期設定を初心者向けに完全解説!
No.5
Java&Spring記事人気No5
Go言語
Swiftの配列(Array)の使い方を完全ガイド!初心者でもわかるデータのまとめ方
No.6
Java&Spring記事人気No6
Go言語
Go言語のgo installコマンドの役割とインストール先の仕組みを徹底解説!
No.7
Java&Spring記事人気No7
Go言語
Go言語のトランザクション処理を完全解説!Begin・Commit・Rollbackを初心者向けにやさしく理解
No.8
Java&Spring記事人気No8
Go言語
Swiftの変数と定数の使い方を完全ガイド!初心者でもわかる基本文法