A quoi sert la commande go install ?

La commande "go install" est utilisée pour compiler et installer les packages de code spécifiés et leurs packages dépendants ; lorsque les packages dépendants du package de code spécifié n'ont pas été compilés et installés, cette commande traitera d'abord les packages dépendants. La commande "go install" placera les fichiers intermédiaires compilés dans le répertoire pkg de GOPATH, et placera définitivement les résultats de la compilation dans le répertoire bin de GOPATH.

L'environnement d'exploitation de ce tutoriel : système Windows 7, GO version 1.18, ordinateur Dell G3.

commande go install - compiler et installer

La commande go install est utilisée pour compiler et installer les packages de code spécifiés et leurs packages dépendants. Lorsque les packages dépendants du package de code spécifié n'ont pas été compilés et installés, cette commande traitera d'abord les packages dépendants. Comme pour la commande go build, l'argument du package de code passé à la commande go install doit être fourni sous la forme d'un chemin d'importation. De plus, la plupart des balises de la commande go build peuvent également être utilisées dans la commande go install. En fait, la commande go install ne fait qu'une chose de plus que la commande go build, c'est-à-dire installer le fichier de résultats compilé dans le répertoire spécifié. go install命令用于编译并安装指定的代码包及它们的依赖包。当指定的代码包的依赖包还没有被编译和安装时，该命令会先去处理依赖包。与go build命令一样，传给go install命令的代码包参数应该以导入路径的形式提供。并且，go build命令的绝大多数标记也都可以用于go install命令。实际上，go install命令只比go build命令多做了一件事，即：安装编译后的结果文件到指定目录。

在对go install命令进行详细说明之前，让我们先回顾一下goc2p的目录结构。为了节省篇幅，我在这里隐藏了代码包中的源码文件。如下：

$HOME/golang/goc2p:
    bin/
    pkg/
    src/
        cnet/
        logging/
        helper/
            ds/
        pkgtool/

我们看到，goc2p项目中有三个子目录，分别是bin目录、pkg目录和src目录。现在只有src目录中包含了一些目录，而其他两个目录都是空的。

现在，我们来看看安装代码包的规则。

安装代码包

如果go install命令后跟的代码包中仅包含库源码文件，那么go install命令会把编译后的结果文件保存在源码文件所在工作区的pkg目录下。对于仅包含库源码文件的代码包来说，这个结果文件就是对应的代码包归档文件（也叫静态链接库文件，名称以.a结尾）。相比之下，我们在使用go build命令对仅包含库源码文件的代码包进行编译时，是不会在当前工作区的src目录以及pkg目录下产生任何结果文件的。结果文件会出于编译的目的被生成在临时目录中，但并不会使当前工作区目录产生任何变化。

如果我们在执行go install命令时不后跟任何代码包参数，那么命令将试图编译当前目录所对应的代码包。比如，我们现在要安装代码包pkgtool：

hc@ubt:~/golang/goc2p/src/pkgtool$ go install -v -work
WORK=D:\cygwin\tmp\go-build758586887
pkgtool

我们在前面说过，执行go install命令后会对指定代码包先编译再安装。其中，编译代码包使用了与go build命令相同的程序。所以，执行go install命令后也会首先建立一个名称以go-build为前缀的临时目录。如果我们想强行重新安装指定代码包及其依赖包，那么就需要加入标记-a:

hc@ubt:~/golang/goc2p/src/pkgtool$ go install -a -v -work
WORK=/tmp/go-build014992994
runtime
errors
sync/atomic
unicode
unicode/utf8
sort
sync
io
syscall
strings
bytes
bufio
time
os
path/filepath
pkgtool

可以看到，代码包pkgtool

Avant de donner une explication détaillée de la commande go install, passons d'abord en revue la structure des répertoires de goc2p. Afin d'économiser de l'espace, j'ai caché ici les fichiers de code source dans le package de code. Comme suit :

$HOME/golang/goc2p:
    bin/
    pkg/
        linux_386/
            pkgtool.a
    src/

On voit qu'il y a trois sous-répertoires dans le projet goc2p, à savoir le répertoire bin, le répertoire pkg et le répertoire src. Désormais, seul le répertoire src contient certains répertoires, tandis que les deux autres répertoires sont vides.

Maintenant, regardons les règles d'installation des packages de code.

Package de code d'installation

Si le package de code suivi de la commande go install contient uniquement le fichier de code source de la bibliothèque, alors la commande go install enregistrera le fichier compilé. fichier de résultats Dans le répertoire pkg de l'espace de travail où se trouve le fichier de code source. Pour les packages de code qui contiennent uniquement des fichiers source de bibliothèque, ce fichier de résultats est le fichier d'archive du package de code correspondant (également appelé fichier de bibliothèque de liens statiques, dont le nom se termine par .a). En revanche, lorsque nous utilisons la commande go build pour compiler un package de code qui contient uniquement les fichiers sources de la bibliothèque, aucun fichier de résultat ne sera généré dans le répertoire src et le répertoire pkg de l'espace de travail actuel. Le fichier résultat sera généré dans un répertoire temporaire à des fins de compilation, mais n'entraînera aucune modification dans le répertoire actuel de l'espace de travail.

Si nous exécutons la commande go install sans aucun paramètre de package de code, la commande tentera de compiler le package de code correspondant au répertoire actuel. Par exemple, nous souhaitons maintenant installer le package de code pkgtool : 🎜

hc@ubt:~/golang/goc2p/src/pkgtool$ go install -a -v -work ../cnet/ctcp
WORK=/tmp/go-build083178213
runtime
errors
sync/atomic
unicode
unicode/utf8
math
sync
sort
io
syscall
internal/singleflight
bytes
strings
strconv
bufio
math/rand
time
reflect
os
fmt
log
runtime/cgo
logging
net
cnet/ctcp

🎜Comme nous l'avons dit précédemment, après avoir exécuté la commande go install, le package de code spécifié sera compilé et puis installé. Parmi eux, le package de code compilé utilise le même programme que la commande go build. Par conséquent, après avoir exécuté la commande go install, un répertoire temporaire avec un nom préfixé par go-build sera d'abord créé. Si nous voulons réinstaller de force le package de code spécifié et ses packages dépendants, nous devons alors ajouter la marque -a:🎜

hc@ubt:~/golang/goc2p/src/cnet/ctcp$ go install -v -work ~/golang/goc2p/src/cnet/ctcp
can't load package: package /home/hc/golang/goc2p/src/cnet/ctcp: import "/home/hc/golang/goc2p/src/cnet/ctcp": cannot import absolute path

🎜Comme vous pouvez le voir, le package de code pkgtool dépend uniquement des packages Go Code de la bibliothèque standard du langage. 🎜🎜Jetons maintenant un coup d'œil au répertoire du projet goc2p : 🎜

$HOME/golang/goc2p:
    bin/
    pkg/
        linux_386/
            /cnet
                ctcp.a
            logging.a
            pkgtool.a
    src/

🎜Il y a maintenant un sous-répertoire supplémentaire dans le répertoire pkg. Les lecteurs qui ont lu la section 0.0 devraient déjà savoir que linux_386 est appelé un répertoire lié à la plate-forme. Son nom peut être obtenu à partir de ${GOOS}_${GOARCH}. Parmi eux, ${GOOS} et ${GOARCH} sont respectivement les valeurs des variables d'environnement GOOS et GOARCH dans le système d'exploitation actuel. Si elles ne sont pas présentes, le langage Go utilise ses valeurs internes prédéterminées. L'exemple ci-dessus est exécuté sur un ordinateur doté d'une architecture de calcul 386 et d'un système d'exploitation Linux. Par conséquent, le répertoire lié à la plate-forme est ici linux_386. Nous voyons également qu'il existe un fichier nommé pkgtool.a dans le répertoire lié à la plateforme du projet goc2p. Il s'agit du fichier d'archive du package de code pkgtool. Le nom du fichier est la combinaison du nom du package de code et du suffixe ".a". 🎜🎜En fait, les fichiers d'archive du package de code ne sont pas toujours enregistrés directement dans le répertoire lié à la plateforme du répertoire pkg, mais peuvent également être enregistrés dans un sous-répertoire de ce répertoire lié à la plateforme. Ensuite nous installons le package cnet/ctcp : 🎜

hc@ubt:~/golang/goc2p/src$ go install helper/ds/showds.go
go install: no install location for .go files listed on command line (GOBIN not set)

🎜 Veuillez noter que nous avons installé le package cnet/ctcp dans le répertoire correspondant au package de code pkgtool. Nous avons utilisé un chemin relatif de répertoire. 🎜🎜En fait, cette méthode permettant de fournir l'emplacement du package de code est appelée méthode de chemin du package de code local, et c'est également une méthode acceptée par toutes les commandes Go, y compris la commande go build qui a été introduite précédemment. Cependant, il convient de noter que le chemin du package de code local ne peut être présenté que sous la forme d'un chemin relatif au répertoire et que le chemin absolu du répertoire ne peut pas être utilisé. Veuillez regarder l'exemple suivant : 🎜

hc@ubt:~/golang/goc2p/src$ echo $GOPATH
/home/hc/golang/lib:/home/hc/golang/goc2p

🎜 À partir des informations d'invite de commande dans l'exemple ci-dessus, nous savons que fournir l'emplacement du package de code sous la forme d'un chemin absolu vers le répertoire ne sera pas reconnu par la commande Go. 🎜

这是由于Go认为本地代码包路径的表示只能以“./”或“../”开始，再或者直接为“.”或“..”，而代码包的代码导入路径又不允许以“/”开始。所以，这种用绝对路径表示代码包位置的方式也就不能被支持了。

上述规则适用于所有Go命令。读者可以自己尝试一下，比如在执行go build命令时分别以代码包导入路径、目录相对路径和目录绝对路径的形式提供代码包位置，并查看执行结果。

我们已经通过上面的示例强行的重新安装了cnet/ctcp包及其依赖包。现在我们再来看一下goc2p的项目目录：

$HOME/golang/goc2p:
    bin/
    pkg/
        linux_386/
            /cnet
                ctcp.a
            logging.a
            pkgtool.a
    src/

我们发现在pkg目录的平台相关目录下多了一个名为cnet的目录，而在这个目录下的就是名为ctcp.a的代码包归档文件。由此我们可知，代码包归档文件的存放目录的相对路径（相对于当前工作区的pkg目录的平台相关目录）即为代码包导入路径除去最后一个元素后的路径。而代码包归档文件的名称即为代码包导入路径中的最后一个元素再加“.a”后缀。再举一个例子，如果代码包导入路径为x/y/z，则它的归档文件存放路径的相对路径即为x/y/，而这个归档文件的名称即为z.a。

回顾代码包pkgtool的归档文件的存放路径。因为它的导入路径中只有一个元素，所以其归档文件就被直接存放到了goc2p项目的pkg目录的平台相关目录下了。

此外，我们还发现pkg目录的平台相关目录下还有一个名为logging.a的文件。很显然，我们并没有显式的安装代码包logging。这是因为go install命令在安装指定的代码包之前，会先去安装指定代码包的依赖包。当依赖包被正确安装后，指定的代码包的安装才会开始。由于代码包cnet/ctcp依赖于goc2p项目（即当前工作区）中的代码包logging，所以当代码包logging被成功安装之后，代码包cnet/ctcp才会被安装。

还有一个问题：上述的安装过程涉及到了那么多代码包，那为什么goc2p项目的pkg目录中只包含该项目中代码包的归档文件呢？实际上，go install命令会把标准库中的代码包的归档文件存放到Go语言安装目录的pkg子目录中，而把指定代码包依赖的第三方项目的代码包的归档文件存放到当前工作区的pkg目录下。这样就实现了Go语言标准库代码包的归档文件与用户代码包的归档文件，以及处在不同工作区的用户代码包的归档文件之间的分离。

安装命令源码文件

除了安装代码包之外，go install命令还可以安装命令源码文件。为了看到安装命令源码文件是goc2p项目目录的变化，我们先把该目录还原到原始状态，即清除bin子目录和pkg子目录下的所有目录和文件。然后，我们来安装代码包helper/ds下的命令源码文件showds.go，如下：

hc@ubt:~/golang/goc2p/src$ go install helper/ds/showds.go
go install: no install location for .go files listed on command line (GOBIN not set)

这次我们没能成功安装。该Go命令认为目录/home/hc/golang/goc2p/src/helper/ds不在环境GOPATH中。我们可以通过Linux的echo命令来查看一下环境变量GOPATH的值：

hc@ubt:~/golang/goc2p/src$ echo $GOPATH
/home/hc/golang/lib:/home/hc/golang/goc2p

环境变量GOPATH的值中确实包含了goc2p项目的根目录。这到底是怎么回事呢？

我通过查看Go命令的源码文件找到了其根本原因。在上一小节我们提到过，在环境变量GOPATH中包含多个工作区目录路径时，我们需要在编译命令源码文件前先对环境变量GOBIN进行设置。实际上，这个环境变量所指的目录路径就是命令程序生成的结果文件的存放目录。go install命令会把相应的可执行文件放置到这个目录中。

由于命令go build在编译库源码文件后不会产生任何结果文件，所以自然也不用会在意结果文件的存放目录。在该命令编译单一的命令源码文件或者包含一个命令源码文件和多个库源码文件时，在结果文件存放目录无效的情况下会将结果文件（也就是可执行文件）存放到执行该命令时所在的目录下。因此，即使环境变量GOBIN的值无效，我们在执行go build命令时也不会见到这个错误提示信息。

然而，go install命令中一个很重要的步骤就是将结果文件（归档文件或者可执行文件）存放到相应的目录中。所以，go install命令在安装命令源码文件时，如果环境变量GOBIN的值无效，则它会在最后检查结果文件存放目录的时候发现这一问题，并打印与上述示例所示内容类似的错误提示信息，最后直接退出。

这个错误提示信息在我们安装多个库源码文件时也有可能遇到。示例如下：

hc@ubt:~/golang/goc2p/src/pkgtool$ go install envir.go fpath.go ipath.go pnode.go util.go
go install: no install location for .go files listed on command line (GOBIN not set)

而且，在我们为环境变量GOBIN设置了正确的值之后，这个错误提示信息仍然会出现。这是因为，只有在安装命令源码文件的时候，命令程序才会将环境变量GOBIN的值作为结果文件的存放目录。而在安装库源码文件时，在命令程序内部的代表结果文件存放目录路径的那个变量不会被赋值。最后，命令程序会发现它依然是个无效的空值。所以，命令程序会同样返回一个关于“无安装位置”的错误。这就引出一个结论，我们只能使用安装代码包的方式来安装库源码文件，而不能在go install命令罗列并安装它们。另外，go install命令目前无法接受标记-o以自定义结果文件的存放位置。这也从侧面说明了go install命令不支持针对库源码文件的安装操作。

至此，我们对怎样用go install命令来安装代码包以及命令源码文件进行了说明。如果你已经熟知了go build命令，那么理解这些内容应该不在话下。

【相关推荐：Go视频教程、编程教学】

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!