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.

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

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

       • Vendor directories are not used in any module. (Vendor directories are not  included  in
         the module zip files downloaded by ‘go install’.)

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

                                            2022-03-15                              GO-INSTALL(1)