Go test Command

Internal

• go Tool
• Go Testing

Overview

The test command runs tests. The shared flags described here apply:

Shared Flags

For more details on testing, in general, see:

Go Testing

go test Execution Modes

The go test runs in two modes: local directory mode and package list mode.

Local Directory Mode

go test runs in local directory mode when it is invoked with no package argument. In this mode, go test compiles the package sources and tests found in the current directory, and then runs the resulting test binary. Caching is disabled. After the package test finishes (what if there are multiple packages?), the runtime print a summary line with the test status ('ok', 'FAIL', package name and elapsed time).