NAME

       go-run - compile and run Go program

SYNOPSIS

       go run [build flags] [-exec xprog] package [arguments...]

DESCRIPTION

       Run compiles and runs the named main Go package.
       Typically  the package is specified as a list of .go source files from a single directory,
       but it may also be an import path, file system path, or pattern matching  a  single  known
       package, as in 'go run .' or 'go run my/cmd'.

       If  the  package  argument has a version suffix (like @latest or @v1.0.0), "go run" builds
       the program in module-aware mode, ignoring the go.mod file in the current directory or any
       parent  directory,  if there is one. This is useful for running programs without affecting
       the dependencies of the main module.

       By default, 'go run' runs the compiled binary directly: 'a.out arguments...'.
       If the -exec flag is given, 'go run' invokes the binary using xprog:

               'xprog a.out arguments...'.

       If the -exec flag is not given, GOOS or GOARCH is different from the system default, and a
       program  named  go_$GOOS_$GOARCH_exec  can  be  found on the current search path, 'go run'
       invokes the binary using that program, for example 'go_js_wasm_exec  a.out  arguments...'.
       This  allows  execution  of  cross-compiled  programs  when a simulator or other execution
       method is available.

       By default, ‘go run’ compiles the  binary  without  generating  the  information  used  by
       debuggers,  to  reduce  build time. To include debugger information in the binary, use ‘go
       build’.

       The exit status of Run is not the exit status of the compiled binary.

       For more about build flags, see 'go help build'.
       For more about specifying packages, see 'go help packages'.

SEE ALSO

       go-build(1).

AUTHOR

       This manual  page  was  written  by  Michael  Stapelberg  <stapelberg@debian.org>  and  is
       maintained  by  the Debian Go Compiler Team <team+go-compiler@tracker.debian.org> based on
       the output of 'go help run' for the Debian project (and may be used by others).

                                            2022-08-02                                  GO-RUN(1)