go get コマンドの用途は何ですか?

青灯夜游
リリース: 2023-01-29 13:49:01
オリジナル
4576 人が閲覧しました

「go get」コマンドは、コード管理ツールを利用してコード パッケージとその依存パッケージをリモートでプルまたは更新し、コンパイルとインストールを自動的に完了します。 「go get」コマンドはリモートコードパッケージを動的に取得することができますが、「go get」コマンドを使用する前に、リモートパッケージに適合するGit、SVN、HGなどのコード管理ツールと、パッケージ名をパラメータで指定する必要があります。

go get コマンドの用途は何ですか?

このチュートリアルの動作環境: Windows 7 システム、GO バージョン 1.18、Dell G3 コンピューター。

go get コマンドは、コード管理ツールを利用してコード パッケージとその依存パッケージをリモートでプルまたは更新し、コンパイルとインストールを自動的に完了できます。プロセス全体はアプリをインストールするのと同じくらい簡単です。

このコマンドは、リモート コード パッケージを動的に取得できます。現在サポートされているのは、BitBucket、GitHub、Google Code、Launchpad です。 go get コマンドを使用する前に、Git、SVN、HG などのリモート パッケージに一致するコード管理ツールをインストールし、パラメーターにパッケージ名を指定する必要があります。

このコマンドは、実際には内部的に 2 つのステップに分かれています。最初のステップはソース コード パッケージをダウンロードすることであり、2 番目のステップは go install を実行することです。

go get コマンド - コードを取得し、ワンクリックでコンパイルしてインストールします。

hc@ubt:~$ go get github.com/hyper-carrot/go_lib/logging
ログイン後にコピー

コマンド go get要求に応じて要求 そして、実際の状況では、指定されたコード パッケージとその依存パッケージをインターネットからダウンロードまたは更新し、コンパイルしてインストールします。上の例では、有名なコード ホスティング サイト Github からプロジェクト (またはコード パッケージ) をダウンロードし、環境変数 GOPATH に含まれる最初のワークスペースにインストールしました。同時に、このコード パッケージのインポート パスが github.com/hyper-キャロット/go_lib/logging であることもわかります。

通常、独自のコードとサードパーティのコードを分離するために、2 つ以上のワークスペースをセットアップします。これで、ディレクトリ パス /home/hc/golang/lib を持つワークスペースができました。これは、環境変数 GOPATH 値の最初のディレクトリ パスです。環境変数 GOPATH に含まれるパスは、環境変数 GOROOT の値と同じにすることはできないことに注意してください。 go get コマンドを使用してコード パッケージをダウンロードしてインストールすると、これらのコード パッケージは上のワークスペースにインストールされます。このワークスペースを一時的に Lib ワークスペースと呼びましょう。 go get github.com/hyper-キャロット/go_lib/logging を実行すると、以下に示すように、コード パッケージが Lib 作業の src ディレクトリに保存され、適切にインストールされているはずです。

/home/hc/golang/lib:
    bin/
    pkg/
        linux_386/
            github.com/
                hyper-carrot/
                    go_lib/
                        logging.a  
    src/
        github.com/
            hyper-carrot/
                go_lib/
                    logging/
    ...
ログイン後にコピー

一方、プロジェクトを Github Web サイト (または他のコード ホスティング Web サイト) にアップロードして他の人が使用したい場合は、プロジェクトをコード パッケージとして扱う必要があります。実際、その理由は前に述べましたが、

go get コマンドは、プロジェクト内のすべてのサブディレクトリとソース コード ファイルを最初のワークスペースの src ディレクトリに保存し、src ディレクトリの下のすべてのサブディレクトリを保存します。特定のコード パッケージのインポート パスの一部またはすべてです。つまり、サブコード パッケージとソース コード ファイルはプロジェクト ディレクトリに直接保存する必要があり、プロジェクト ディレクトリに直接保存されているソース コード ファイルによって宣言されるパッケージ名は、(コマンド ソースでない限り) プロジェクト名と同じである必要があります。コードファイル)。これを行うと、go get コマンドを使用して Github サイトからプロジェクトをダウンロードした後、他の人が直接プロジェクトを使用できるようになります。

実際には、goc2p プロジェクトのように、プロジェクトのルート ディレクトリのパスをワークスペース パスとして直接使用することはお勧めできません。これを行う主な理由は、読者が Go 言語のプロジェクト構造とワークスペースの概念を理解しやすくすることと、別のプロジェクト構造を読者が確認できるようにすることです。もちろん、プロジェクトで

gb のようなツールを使用している場合は、別の問題になります。このようなプロジェクトのルート ディレクトリはワークスペースと見なす必要があります (ただし、GOPATH 環境変数に追加する必要はありません)。 go get コマンドを使用する代わりに、git clone によって Go 言語ワークスペースの外のどこかにダウンロードする必要があります。

リモート インポート パスの分析

実際、

go get コマンドによって実行されるアクションはコード パッケージ リモート インポートとも呼ばれ、渡されます。コード パッケージのインポート パスであるコマンドのパラメーターは、コード パッケージのリモート インポート パスとも呼ばれます。

go get コマンドは、Github などの有名なコード ホスティング サイトからコード パッケージをダウンロードできるだけでなく、任意のコード バージョン管理システム (英語のバージョン管理システム、「チェックアウト」と呼ばれます) からもコード パッケージをダウンロードできます。 VCS 用のコード パッケージ)。どのコード ホスティング サイトでも、1 つ以上のコード バージョン管理システムを通じてコードのアップロードおよびダウンロード サービスが提供されます。したがって、より厳密に言えば、go get コマンドが行うことは、コード バージョン管理システムのリモート リポジトリからコード パッケージをチェックアウト/更新し、コンパイルしてインストールすることです。

このコマンドでサポートされる VCS 情報は次のとおりです。

表 0-2 go getコマンドでサポートされる VCS

#名前メインコマンド説明##MercurialGitSubversionBazaar
hgMercurial は、Python 言語で実装された軽量の分散バージョン管理システムで、学習と使用が簡単で、拡張性が高くなります。
gitGit はもともと、Linux カーネル開発の管理を支援するために Linux Torvalds によって開発されたオープン ソースの分散バージョン管理ソフトウェアでした。しかし、今では広く使われています。あらゆる規模のプロジェクトの効率的かつ高速なバージョン管理に使用されます。
svnSubversion はバージョン管理システムであり、ブランチの概念と機能をバージョン管理モデルに組み込んだ最初のシステムです。ただし、Git や Mercurial と比較すると、これは従来のバージョン管理システムのメンバーにすぎません。
bzrBazaar は、オープンソースの分散バージョン管理システムです。しかしそれに比べて、VCS として使用するプロジェクトは多くありません。
go get

コマンドは、チェックする前に、コード パッケージのリモート インポート パスに対応するバージョン管理システムとリモート ウェアハウスの URL を知っている必要があります。コードパッケージを取り出します。 コード パッケージがローカル ワークスペースにすでに存在する場合、これらの情報はそのパスを分析することによって直接決定されます。

go get

コマンドでサポートされているいくつかのバージョン管理システムには共通点が 1 つあります。つまり、メタデータ ディレクトリは、名前の先頭に "." とそのメイン ディレクトリが付けられて、チェックアウトされたプロジェクト ディレクトリに保存されるということです。コマンド名。たとえば、Git はチェックアウトされたプロジェクト ディレクトリに「.git」という名前のサブディレクトリを追加します。したがって、コード パッケージで使用されるバージョン管理システムを決定するのは簡単です。さらに、コード パッケージはすでに存在しているため、コード バージョン管理システムの更新コマンドを使用してコード パッケージを更新するだけでよく、そのリモート ウェアハウスの URL を知る必要はありません。ローカル ワークスペースに既に存在するコード パッケージの場合、コード パッケージが強制的に更新されない限り、go get コマンドは繰り返しダウンロードを実行しません。コード パッケージを強制的に更新する場合は、go get コマンドの実行時に -u タグを追加します。このマークアップは後で紹介します。 コード パッケージがローカル ワークスペースに存在しない場合、関連情報はコード パッケージのリモート インポート パスを分析することによってのみ取得できます。まず、

go get

コマンドは、コード パッケージのリモート インポート パスで静的分析を実行します。分析プロセスをより便利かつ高速にするために、go get コマンド プログラムには、いくつかの有名なコード ホスティング Web サイトの情報がプリセットされています。次の表に示すように:

表 0-3 プリセット コード ホスティング サイトに関する情報

名前Bitbucketbitbucket.org/user/project/sub/directory #GitHubgithub.com/user/project/sub/directoryGoogle コード プロジェクト ホスティングcode.google.com/p/project/sub/directoryLaunchpadlaunchpad.net/project/seriesIBM DevOps サービスhub.jazz .net/ git/user/project/sub/directory

一般情况下,代码包远程导入路径中的第一个元素就是代码托管网站的主域名。在静态分析的时候,go get命令会将代码包远程导入路径与预置的代码托管站点的主域名进行匹配。如果匹配成功,则在对代码包远程导入路径的初步检查后返回正常的返回值或错误信息。如果匹配不成功,则会再对代码包远程导入路径进行动态分析。至于动态分析的过程,我就不在这里详细展开了。

如果对代码包远程导入路径的静态分析或/和动态分析成功并获取到对应的版本控制系统和远程仓库URL,那么go get命令就会进行代码包检出或更新的操作。随后,go get命令会在必要时以同样的方式检出或更新这个代码包的所有依赖包。

自定义代码包远程导入路径

如果你想把你编写的(被托管在不同的代码托管网站上的)代码包的远程导入路径统一起来,或者不希望让你的代码包中夹杂某个代码托管网站的域名,那么你可以选择自定义你的代码包远程导入路径。这种自定义的实现手段叫做“导入注释”。导入注释的写法示例如下:

package analyzer // import "hypermind.cn/talon/analyzer"
ログイン後にコピー

代码包analyzer实际上属于我的一个网络爬虫项目。这个项目的代码被托管在了Github网站上。它的网址是:https://github.com/hyper-carrot/talon。如果用标准的导入路径来下载analyzer代码包的话,命令应该这样写go get github.com/hyper-carrot/talon/analyzer。不过,如果我们像上面的示例那样在该代码包中的一个源码文件中加入导入注释的话,这样下载它就行不通了。我们来看一看这个导入注释。

导入注释的写法如同一条代码包导入语句。不同的是,它出现在了单行注释符//的右边,因此Go语言编译器会忽略掉它。另外,它必须出现在源码文件的第一行语句(也就是代码包声明语句)的右边。只有符合上述这两个位置条件的导入注释才是有效的。再来看其中的引号部分。被双引号包裹的应该是一个符合导入路径语法规则的字符串。其中,hypermind.cn是我自己的一个域名。实际上,这也是用来替换掉我想隐去的代码托管网站域名及部分路径(这里是github.com/hyper-carrot)的那部分。在hypermind.cn右边的依次是我的项目的名称以及要下载的那个代码包的相对路径。这些与其标准导入路径中的内容都是一致的。为了清晰起见,我们再来做下对比。

github.com/hyper-carrot/talon/analyzer // 标准的导入路径
hypermind.cn           /talon/analyzer // 导入注释中的导入路径
ログイン後にコピー

你想用你自己的域名替换掉标准导入路径中的哪部分由你自己说了算。不过一般情况下,被替换的部分包括代码托管网站的域名以及你在那里的用户ID就可以了。这足以达到我们最开始说的那两个目的。

虽然我们在talon项目中的所有代码包中都加入了类似的导入注释,但是我们依然无法通过go get hypermind.cn/talon/analyzer命令来下载这个代码包。因为域名hypermind.cn所指向的网站并没有加入相应的处理逻辑。具体的实现步骤应该是这样的:

  • 编写一个可处理HTTP请求的程序。这里无所谓用什么编程语言去实现。当然,我推荐你用Go语言去做。

  • 将这个处理程序与hypermind.cn/talon这个路径关联在一起,并总是在作为响应的HTML文档的头中写入下面这行内容:

    <meta name="go-import" content="hypermind.cn/talon git https://github.com/hyper-carrot/talon">
    ログイン後にコピー

    hypermind.cn/talon/analyzer熟悉HTML的读者都应该知道,这行内容会被视为HTML文档的元数据。它实际上go get命令的文档中要求的写法。它的模式是这样的:

<meta name="go-import" content="import-prefix vcs repo-root">
ログイン後にコピー

实际上,content属性中的import-prefix的位置上应该填入我们自定义的远程代码包导入路径的前缀。这个前缀应该与我们的处理程序关联的那个路径相一致。而vcs显然应该代表与版本控制系统有关的标识。还记得表0-2中的主命令列吗?这里的填入内容就应该该列中的某一项。在这里,由于talon项目使用的是Git,所以这里应该填入git。至于repo-root,它应该是与该处理程序关联的路径对应的Github网站的URL。在这里,这个路径是hypermind.cn/talon,那么这个URL就应该是https://github.com/hyper-carrot/talon。后者也是talon项目的实际网址。

好了,在我们做好上述处理程序之后,go get hypermind.cn/talon/analyzer命令的执行结果就会是正确的。analyzer代码包及其依赖包中的代码会被下载到GOPATH环境变量中的第一个工作区目录的src子目录中,然后被编译并安装。

注意,具体的代码包源码存放路径会是/home/hc/golang/lib/src/hypermind.cn/talon/analyzer。也就是说,存放路径(包括代码包源码文件以及相应的归档文件的存放路径)会遵循导入注释中的路径(这里是hypermind.cn/talon/analyzer),而不是原始的导入路径(这里是github.com/hyper-carrot/talon/analyzer)。另外,我们只需在talon项目的每个代码包中的某一个源码文件中加入导入注释,但这些导入注释中的路径都必须是一致的。在这之后,我们就只能使用hypermind.cn/talon/作为talon项目中的代码包的导入路径前缀了。一个反例如下:

hc@ubt:~$ go get github.com/hyper-carrot/talon/analyzer
package github.com/hyper-carrot/talon/analyzer: code in directory /home/hc/golang/lib/src/github.com/hyper-carrot/talon/analyzer expects import "hypermind.cn/talon/analyzer"
ログイン後にコピー

与自定义的代码包远程导入路径有关的内容我们就介绍到这里。从中我们也可以看出,Go语言为了让使用者的项目与代码托管网站隔离所作出的努力。只要你有自己的网站和一个不错的域名,这就很容易搞定并且非常值得。这会在你的代码包的使用者面前强化你的品牌,而不是某个代码托管网站的。当然,使你的代码包导入路径整齐划一是最直接的好处。

OK,言归正传,我下面继续关注go get这个命令本身。

命令特有标记

go get命令可以接受所有可用于go build命令和go install命令的标记。这是因为go get命令的内部步骤中完全包含了编译和安装这两个动作。另外,go get命令还有一些特有的标记,如下表所示:

表0-4 go get命令的特有标记说明

マスター ドメイン名サポートされる VCSコード パッケージのリモート インポート パスの例
bitbucket.org Git、Mercurialbitbucket.org/user/project
github.comGitgithub.com/user/project
code.google.comGit、Mercurial、Subversioncode.google.com/p/projectcode.google.com/p/project.subrepository
code.google.com/p/project.subrepository/sub/directory

launchpad.netバザールlaunchpad.net/projectlaunchpad .net/project/series/sub/directory
launchpad.net/
user/project/branch
launchpad.net/user/project/branch/sub/directory
hub.jazz.netGithub.jazz.net/git/user/project
标记名称标记描述
-d让命令程序只执行下载动作,而不执行安装动作。
-f仅在使用-u标记时才有效。该标记会让命令程序忽略掉对已下载代码包的导入路径的检查。如果下载并安装的代码包所属的项目是你从别人那里Fork过来的,那么这样做就尤为重要了。
-fix让命令程序在下载代码包后先执行修正动作,而后再进行编译和安装。
-insecure允许命令程序使用非安全的scheme(如HTTP)去下载指定的代码包。如果你用的代码仓库(如公司内部的Gitlab)没有HTTPS支持,可以添加此标记。请在确定安全的情况下使用它。
-t让命令程序同时下载并安装指定的代码包中的测试源码文件中依赖的代码包。
-u让命令利用网络来更新已有代码包及其依赖包。默认情况下,该命令只会从网络上下载本地不存在的代码包,而不会更新已有的代码包。

为了更好的理解这几个特有标记,我们先清除Lib工作区的src目录和pkg目录中的所有子目录和文件。现在我们使用带有-d标记的go get命令来下载同样的代码包:

hc@ubt:~$ go get -d github.com/hyper-carrot/go_lib/logging
ログイン後にコピー

现在,让我们再来看一下Lib工作区的目录结构:

/home/hc/golang/lib:
    bin/
    pkg/
    src/
        github.com/
        hyper-carrot/
        go_lib/
            logging/
    ...
ログイン後にコピー

我们可以看到,go get命令只将代码包下载到了Lib工作区的src目录,而没有进行后续的编译和安装动作。这个加入-d标记的结果。

再来看-fix标记。我们知道,绝大多数计算机编程语言在进行升级和演进过程中,不可能保证100%的向后兼容(Backward Compatibility)。在计算机世界中,向后兼容是指在一个程序或者代码库在更新到较新的版本后,用旧的版本程序创建的软件和系统仍能被正常操作或使用,或在旧版本的代码库的基础上编写的程序仍能正常编译运行的能力。Go语言的开发者们已想到了这点,并提供了官方的代码升级工具——fixfix工具可以修复因Go语言规范变更而造成的语法级别的错误。关于fix工具,我们将放在本节的稍后位置予以说明。

假设我们本机安装的Go语言版本是1.5,但我们的程序需要用到一个很早之前用Go语言的0.9版本开发的代码包。那么我们在使用go get命令的时候可以加入-fix标记。这个标记的作用是在检出代码包之后,先对该代码包中不符合Go语言1.5版本的语言规范的语法进行修正,然后再下载它的依赖包,最后再对它们进行编译和安装。

标记-u的意图和执行的动作都比较简单。我们在执行go get命令时加入-u标记就意味着,如果在本地工作区中已存在相关的代码包,那么就是用对应的代码版本控制系统的更新命令更新它,并进行编译和安装。这相当于强行更新指定的代码包及其依赖包。我们来看如下示例:

hc@ubt:~$ go get -v github.com/hyper-carrot/go_lib/logging
ログイン後にコピー

因为我们在之前已经检出并安装了这个代码包,所以我们执行上面这条命令后什么也没发生。还记得加入标记-v标记意味着会打印出被构建的代码包的名字吗?现在我们使用标记-u来强行更新代码包:

hc@ubt:~$ go get -v -u  github.com/hyper-carrot/go_lib/logging
github.com/hyper-carrot/go_lib (download)
ログイン後にコピー

其中,“(download)”后缀意味着命令从远程仓库检出或更新了该行显示的代码包。如果我们要查看附带-ugo get命令到底做了些什么,还可以加上一个-x标记,以打印出用到的命令。读者可以自己试用一下它。

智能的下载

命令go get还有一个很值得称道的功能。在使用它检出或更新代码包之后,它会寻找与本地已安装Go语言的版本号相对应的标签(tag)或分支(branch)。比如,本机安装Go语言的版本是1.x,那么go get命令会在该代码包的远程仓库中寻找名为“go1”的标签或者分支。如果找到指定的标签或者分支,则将本地代码包的版本切换到此标签或者分支。如果没有找到指定的标签或者分支,则将本地代码包的版本切换到主干的最新版本。

前面我们说在执行go get命令时也可以加入-x标记,这样可以看到go get命令执行过程中所使用的所有命令。不知道读者是否已经自己尝试了。下面我们还是以代码包github.com/hyper-carrot/go_lib为例,并且通过之前示例中的命令的执行此代码包已经被检出到本地。这时我们再次更新这个代码包:

hc@ubt:~$ go get -v -u -x github.com/hyper-carrot/go_lib
github.com/hyper-carrot/go_lib (download)
cd /home/hc/golang/lib/src/github.com/hyper-carrot/go_lib
git fetch
cd /home/hc/golang/lib/src/github.com/hyper-carrot/go_lib
git show-refcd /home/hc/golang/lib/src/github.com/hyper-carrot/go_lib
git checkout origin/masterWORK=/tmp/go-build034263530
ログイン後にコピー

在上述示例中,go get命令通过git fetch命令将所有远程分支更新到本地,而后有用git show-ref命令列出本地和远程仓库中记录的代码包的所有分支和标签。最后,当确定没有名为“go1”的标签或者分支后,go get命令使用git checkout origin/master命令将代码包的版本切换到主干的最新版本。下面,我们在本地增加一个名为“go1”的标签,看看go get命令的执行过程又会发生什么改变:

hc@ubt:~$ cd ~/golang/lib/src/github.com/hyper-carrot/go_lib
hc@ubt:~/golang/lib/src/github.com/hyper-carrot/go_lib$ git tag go1
hc@ubt:~$ go get -v -u -x github.com/hyper-carrot/go_lib
github.com/hyper-carrot/go_lib (download)
cd /home/hc/golang/lib/src/github.com/hyper-carrot/go_lib
git fetch
cd /home/hc/golang/lib/src/github.com/hyper-carrot/go_lib
git show-ref
cd /home/hc/golang/lib/src/github.com/hyper-carrot/go_lib
git show-ref tags/go1 origin/go1
cd /home/hc/golang/lib/src/github.com/hyper-carrot/go_lib
git checkout tags/go1
WORK=/tmp/go-build636338114
ログイン後にコピー

将这两个示例进行对比,我们会很容易发现它们之间的区别。第二个示例的命令执行过程中使用git show-ref查看所有分支和标签,当发现有匹配的信息又通过git show-ref tags/go1 origin/go1命令进行精确查找,在确认无误后将本地代码包的版本切换到标签“go1”之上。

コマンドgo getこの関数は非常に便利です。コードが、複数の Go 言語バージョン用に同時に開発されたコード パッケージに直接的または間接的に依存している場合、正しいバージョンを自動的にチェックアウトできます。 go get コマンドには、コード パッケージのマルチバージョンの依存関係を管理するための機能が組み込まれているとも言えます。

ここでは、go get コマンドの使い方を紹介します。 go get コマンドは、前に紹介した 2 つのコマンドと同様、Go 言語プログラムを作成したり、Go 言語プロジェクトを構築したりするときに欠かせない補助ツールです。

【関連する推奨事項: Go ビデオ チュートリアル プログラミング教育

以上がgo get コマンドの用途は何ですか?の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。

関連ラベル:
ソース:php.cn
このウェブサイトの声明
この記事の内容はネチズンが自主的に寄稿したものであり、著作権は原著者に帰属します。このサイトは、それに相当する法的責任を負いません。盗作または侵害の疑いのあるコンテンツを見つけた場合は、admin@php.cn までご連絡ください。
人気のチュートリアル
詳細>
最新のダウンロード
詳細>
ウェブエフェクト
公式サイト
サイト素材
フロントエンドテンプレート