NAME

       go-get - add dependencies to current module and install them

SYNOPSIS

       go get [-d] [-t] [-u] [-v] [build flags] [packages]

DESCRIPTION

       Get  resolves  its  command-line  arguments  to  packages  at specific module versions, updates go.mod to
       require those versions, downloads source code into the module cache, then builds and installs  the  named
       packages.

       To add a dependency for a package or upgrade it to its latest version:

               go get example.com/pkg

       To upgrade or downgrade a package to a specific version:

               go get example.com/pkg@v1.2.3

       To remove a dependency on a module and downgrade modules that require it:

               go get example.com/mod@none

       See https://golang.org/ref/mod#go-get for details.

       The  'go  install'  command  may  be used to build and install packages. When a version is specified, 'go
       install' runs in module-aware mode and ignores the go.mod file in the current directory. For example:

               go install example.com/pkg@v1.2.3
               go install example.com/pkg@latest

       See 'go help install' or https://golang.org/ref/mod#go-install for details.

       In addition to build flags (listed in 'go help build') 'go get' accepts the following flags.

       -t     The -t flag instructs get to consider modules needed to build tests of packages specified  on  the
              command line.

       -u     The  -u  flag  instructs  get  to  update  modules providing dependencies of packages named on the
              command line to use newer minor or patch releases when available.

       -u=patch
              The -u=patch flag (not -u patch) also instructs  get  to  update  dependencies,  but  changes  the
              default to select patch releases.

       When the -t and -u flags are used together, get will update test dependencies as well.

       -d     The  -d  flag  instructs  get  not  to  build or install packages. get will only update go.mod and
              download source code needed to build packages.

       Building and installing packages with get is deprecated. In a future release, the -d flag will be enabled
       by default, and 'go get' will be only be used to adjust dependencies of the current module. To install  a
       package  using  dependencies from the current module, use 'go install'. To install a package ignoring the
       current module, use 'go install' with an @version suffix like "@latest" after each argument.

       For more about modules, see https://golang.org/ref/mod.

       For more about specifying packages, see go-packages(7).

       This text describes the behavior of get using modules to manage source code and dependencies. If  instead
       the go command is running in GOPATH mode, the details of get's flags and effects change, as does 'go help
       get'.  See 'go help gopath-get' or go-gopath-get(1).

SEE ALSO

       go-build(1), go-install(1), go-clean(1).  go-mod(1).

AUTHOR

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

                                                   2021-10-15                                          GO-GET(1)