NAME

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

SYNOPSIS

       go get [-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, and downloads source code into the module cache.

       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.

       In earlier versions of Go, ‘go get’ was used to build and install packages.  Now, ‘go get’
       is  dedicated  to  adjusting dependencies in go.mod. ‘go install' may be used to build and
       install commands instead. 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.

       ‘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.

       -x     The -x flag prints commands as they are executed.  This  is  useful  for  debugging
              version control commands when a module is downloaded directly from a repository.

       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)