NAME

       go - tool for managing Go source code

SYNOPSIS

       go install [build flags] [packages]

DESCRIPTION

       Install compiles and installs the packages named by the import paths.

       Executables  are installed in the directory named by the GOBIN environment variable, which
       defaults to $GOPATH/bin or $HOME/go/bin if the GOPATH environment  variable  is  not  set.
       Executables in $GOROOT are installed in $GOROOT/bin or $GOTOOLDIR instead of $GOBIN.

       If  the  arguments  have  version  suffixes (like @latest or @v1.0.0), "go install" builds
       packages 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 installing executables without
       affecting the dependencies of the main module.  To eliminate ambiguity about which  module
       versions are used in the build, the arguments must satisfy the following constraints:

       • Arguments  must  be package paths or package patterns (with "..." wildcards).  They must
         not be standard packages (like fmt), meta-patterns  (std,  cmd,  all),  or  relative  or
         absolute file paths.

       • All arguments must have the same version suffix. Different queries are not allowed, even
         if they refer to the same version.

       • All arguments must refer to packages in the same module at the same version.

       • No module is considered the "main" module. If the module containing  packages  named  on
         the command line has a go.mod file, it must not contain directives (replace and exclude)
         that would cause it to be interpreted differently than if it were the main  module.  The
         module must not require a higher version of itself.

       • Package  path  arguments  must refer to main packages. Pattern arguments will only match
         main packages.

       If the arguments don't have version suffixes, "go install" may run in module-aware mode or
       GOPATH  mode,  depending  on  the  GO111MODULE  environment variable and the presence of a
       go.mod file. See 'go help modules' for details.  If  module-aware  mode  is  enabled,  "go
       install" runs in the context of the main module.

       When  module-aware  mode  is  disabled,  other  packages  are  installed  in the directory
       $GOPATH/pkg/$GOOS_$GOARCH. When module-aware mode is enabled, other packages are built and
       cached but not installed.

       The -i flag installs the dependencies of the named packages as well.
       The -i flag is deprecated. Compiled packages are cached automatically.

       For more about the build flags, see go-build(1).
       For more about specifying packages, see go-packages(7).

SEE ALSO

       go-build(1), go-get(1), go-clean(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 install' for the Debian project (and may be used by others).

                                            2021-09-06                              GO-INSTALL(1)