Arahan "go install" digunakan untuk menyusun dan memasang pakej kod yang ditentukan dan pakej bergantungnya apabila pakej bergantung bagi pakej kod yang ditentukan belum disusun dan dipasang, arahan ini akan memproses tanggungan terlebih dahulu; pakej . Arahan "go install" akan meletakkan fail perantaraan yang disusun dalam direktori pkg GOPATH dan meletakkan hasil kompilasi secara kekal dalam direktori bin GOPATH.
Persekitaran pengendalian tutorial ini: sistem Windows 7, GO versi 1.18, komputer Dell G3. Perintah
go install - compile and install
go install
arahan digunakan untuk menyusun dan memasang pakej kod yang ditentukan dan pakej bergantungnya. Apabila pakej bergantung bagi pakej kod yang ditentukan belum disusun dan dipasang, arahan ini akan terlebih dahulu memproses pakej bergantung. Seperti perintah go build
, parameter pakej kod yang dihantar kepada perintah go install
hendaklah disediakan dalam bentuk laluan import. Selain itu, kebanyakan teg perintah go build
juga boleh digunakan dalam perintah go install
. Malah, arahan go install
hanya melakukan satu perkara lagi daripada perintah go build
, iaitu: pasang fail hasil yang dikompilasi ke direktori yang ditentukan.
Sebelum memberikan penjelasan terperinci tentang arahan go install, mari kita semak struktur direktori goc2p dahulu. Untuk menjimatkan ruang, saya telah menyembunyikan fail kod sumber dalam pakej kod di sini. Seperti berikut:
$HOME/golang/goc2p: bin/ pkg/ src/ cnet/ logging/ helper/ ds/ pkgtool/
Kami melihat terdapat tiga subdirektori dalam projek goc2p, iaitu direktori bin, direktori pkg dan direktori src. Kini hanya direktori src yang mengandungi beberapa direktori, manakala dua lagi direktori kosong.
Sekarang, mari lihat peraturan untuk memasang pakej kod.
Pasang pakej kod
Jika pakej kod diikuti dengan arahan go install
hanya mengandungi fail kod sumber perpustakaan, maka perintah go install
akan menyimpan fail hasil terkumpul Dalam direktori pkg ruang kerja tempat fail kod sumber terletak. Untuk pakej kod yang hanya mengandungi fail sumber perpustakaan, fail hasil ini ialah fail arkib pakej kod yang sepadan (juga dipanggil fail pustaka pautan statik, namanya berakhir dengan .a). Sebaliknya, apabila kami menggunakan perintah go build
untuk menyusun pakej kod yang hanya mengandungi fail sumber perpustakaan, tiada fail hasil akan dijana dalam direktori src dan direktori pkg ruang kerja semasa. Fail hasil akan dijana dalam direktori sementara untuk tujuan penyusunan, tetapi tidak akan menyebabkan sebarang perubahan pada direktori ruang kerja semasa.
Jika kami melaksanakan perintah go install
tanpa sebarang parameter pakej kod, arahan itu akan cuba menyusun pakej kod yang sepadan dengan direktori semasa. Sebagai contoh, kami kini ingin memasang pakej kod pkgtool
:
hc@ubt:~/golang/goc2p/src/pkgtool$ go install -v -work WORK=D:\cygwin\tmp\go-build758586887 pkgtool
Seperti yang kami katakan sebelum ini, selepas melaksanakan perintah go install
, pakej kod yang ditentukan akan disusun dan kemudian dipasang. Antaranya, pakej kod yang disusun menggunakan program yang sama seperti arahan go build
. Oleh itu, selepas melaksanakan perintah go install
, direktori sementara dengan nama yang diawali dengan go-build akan dibuat terlebih dahulu. Jika kami ingin memasang semula pakej kod yang ditentukan dan pakej bergantungnya secara paksa, kami perlu menambah teg -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
Seperti yang anda lihat, pakej kod pkgtool
hanya bergantung pada Pakej kod standard bahasa Go.
Sekarang mari kita lihat direktori projek goc2p:
$HOME/golang/goc2p: bin/ pkg/ linux_386/ pkgtool.a src/
Kini terdapat subdirektori tambahan dalam direktori pkg. Pembaca yang telah membaca Bahagian 0.0 sepatutnya sudah tahu bahawa linux_386 dipanggil direktori berkaitan platform. Namanya boleh didapati daripada ${GOOS}_${GOARCH}. Antaranya, ${GOOS} dan ${GOARCH} ialah nilai pembolehubah persekitaran GOOS dan GOARCH masing-masing dalam sistem pengendalian semasa. Jika mereka tidak hadir, bahasa Go menggunakan nilai yang telah ditetapkan dalamannya. Contoh di atas dijalankan pada komputer dengan seni bina pengiraan 386 dan sistem pengendalian Linux. Oleh itu, direktori berkaitan platform di sini ialah linux_386. Kami juga melihat bahawa terdapat fail bernama pkgtool.a dalam direktori berkaitan platform dalam projek goc2p. Ini ialah fail arkib pakej kod pkgtool Nama fail ialah gabungan nama pakej kod dan akhiran ".a".
Malah, fail arkib pakej kod tidak selalu disimpan terus dalam direktori berkaitan platform bagi direktori pkg, tetapi mungkin juga disimpan dalam subdirektori direktori berkaitan platform ini. Seterusnya kami memasang pakej cnet/ctcp:
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
Sila ambil perhatian bahawa kami memasang pakej cnet/ctcp dalam direktori yang sepadan dengan pakej kod pkgtool. Kami menggunakan laluan relatif direktori.
Malah, kaedah menyediakan lokasi pakej kod ini dipanggil kaedah laluan pakej kod tempatan, dan ia juga merupakan kaedah yang diterima oleh semua arahan Go, termasuk arahan go build yang telah diperkenalkan sebelum ini . Walau bagaimanapun, perlu diingatkan bahawa laluan pakej kod tempatan hanya boleh dibentangkan dalam bentuk laluan relatif direktori, dan laluan mutlak direktori tidak boleh digunakan. Sila lihat contoh berikut:
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
Daripada maklumat gesaan arahan dalam contoh di atas, kami tahu bahawa menyediakan lokasi pakej kod dalam bentuk laluan mutlak ke direktori tidak akan dikenali oleh Go perintah.
这是由于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命令,那么理解这些内容应该不在话下。
Atas ialah kandungan terperinci Apakah kegunaan arahan go install?. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!