モジュールの依存関係の管理と使用をゴーゴー

言語の変更のバージョンに依存関係の管理を行くが徐々に完成されます。

依存関係の管理

なぜ管理に依存しています

最初の時間は、すべてのサードパーティのライブラリに依存していますGOPATHにこのディレクトリを配置しています。これは、コードの1つのバージョンのみを保存することができ、同じライブラリにつながります。異なるプロジェクトが別のバージョンでサードパーティのライブラリに依存している場合どのように解決するには？

godep

当初は導入を開始したからV1.5言語を行くvendorのベンダーのディレクトリはプロジェクトディレクトリの下に存在する場合、その後の使用を優先させて頂きますツールチェーンを行く、モードをvendorようにテストすると、コンパイルパッケージ。

godep行く言語はコミュニティだけでなく、ベンダーモードで実装同様の準公式のパッケージ管理ツールによって維持、サードパーティの依存関係の管理ツールですdep。

インストール

インストールするには、次のコマンドを実行godepツールを。

go get github.com/tools/godep

基本コマンド

godepインストールした後、ターミナルで入力godepサポートされるすべてのコマンドを参照してください。

godep save     将依赖项输出并复制到Godeps.json文件中
godep go       使用保存的依赖项运行go工具
godep get      下载并安装具有指定依赖项的包
godep path     打印依赖的GOPATH路径
godep restore  在GOPATH中拉取依赖的版本
godep update   更新选定的包或go版本
godep diff     显示当前和以前保存的依赖项集之间的差异
godep version  查看版本信息

使用して、godep help [command]特定のコマンドのヘルプ情報を見ることができます。

godep使用します

プロジェクトディレクトリの実装ではgodep save、コマンド現在のプロジェクトで作成されたGodepsし、vender2つのフォルダ。

前記GodepsフォルダがありGodeps.json、パケットの情報項目を記録したファイルを、依存しています。venderフォルダには、ソースコードファイルのパッケージに依存したプロジェクトです。

ベンダーメカニズム

Go1.5のバージョンはサポートし始めた後、ゴー言語コンパイラプログラムは、パケットの優先順位の検索パスに依存し制御することができます。

例えば、最初のプロジェクトを見つけるために、プロジェクトの依存関係がのルートディレクトリになりますvenderが見つからない場合は、それがために行くだろう、見つけるために、ファイルフォルダ$GOAPTH/srcのディレクトリを見つけます。

godep開発プロセス

1. 通常のをコンパイルする保証手順
2. 実行は、godep saveすべてのサードパーティの情報とコードに依存バージョンの現在のプロジェクトを保存します
3. ベンダーコードベースにGodepsディレクトリとディレクトリの提出。
4. あなたはバージョン依存を更新したい場合は、直接変更することができGodeps.json、ファイルに対応するエントリを

モジュールを行きます

go moduleGo1.11バージョンは、バージョン管理ツールの公式発表で、Go1.13版から後は、go moduleデフォルトの言語は、依存関係の管理ツールを行くだろう。

GO111MODULE

有効にするためにgo moduleサポートが最初に環境変数を設定する必要がありますGO111MODULEモジュールのサポートを経由してオンまたはオフにすることができ、それは3つの値があります。off、、 on、autoデフォルトですauto。

1. GO111MODULE=offモジュールのサポートを無効にし、それはコンパイル時であろうGOPATHと、vendorパッケージフォルダを見つけます。
2. GO111MODULE=onコンパイル時にモジュールを有効にすると無視をサポートしGOPATHやvendorフォルダのみに基づく、go.mod依存関係をダウンロードしてください。
3. GO111MODULE=autoプロジェクト場合は$GOPATH/src、プロジェクトのルートディレクトリと外部のgo.modファイルは、開くモジュールをサポートしています。

簡単に言えば、設定GO111MODULE=onあなたが使用できる後go moduleにGOPATHでプロジェクトを作成する必要がないため、と、ともうまく管理することができたプロジェクトは、サードパーティのパッケージ情報を依存しています。

ゴーモジュール管理を使用した後は、プロジェクトのルートディレクトリに2つのファイルを生成し頼っているgo.modとgo.sum。

GOPROXY

Go1.11は後GOPROXYコマンドを設定します。

export GOPROXY=https://goproxy.cn

Go1.13後にGOPROXYデフォルト値https://proxy.golang.org国ではアクセスできません、私が使用することをお勧めします、あなたはGOPROXYを設定することをお勧めしgoproxy.cnを。

go env -w GOPROXY=https://goproxy.cn,direct

modコマンドを行きます

一般的に使用されるgo mod次のようにコマンドは次のとおりです。

go mod download 下载依赖的module到本地cache（默认为$GOPATH/pkg/mod目录）

go mod edit 编辑go.mod文件

go mod graph 打印模块依赖图

go mod init 初始化当前文件夹, 创建go.mod文件

go mod tidy 增加缺少的module，删除无用的module

go mod vendor 将依赖复制到vendor下

go mod verify 校验依赖

go mod why 解释为什么需要依赖


<h3 id="go-mod">go.mod</h3>

<p>go.mod文件记录了项目所有的依赖信息，其结构大致如下：</p>

<pre><code class="language-sh">module github.com/Q1mi/studygo/blogger

go 1.12

require (
    github.com/DeanThompson/ginpprof v0.0.0-20190408063150-3be636683586
    github.com/gin-gonic/gin v1.4.0
    github.com/go-sql-driver/mysql v1.4.1
    github.com/jmoiron/sqlx v1.2.0
    github.com/satori/go.uuid v1.2.0
    google.golang.org/appengine v1.6.1 // indirect
)
其中，

  
  


   
   
module用来定义包名

   
   
require用来定义依赖包及版本

   
   
indirect表示间接引用

  
  
依赖的版本
go mod支持语义化版本号，比如go get [email protected]，也可以跟git的分支或tag，比如go get foo@master，当然也可以跟git提交哈希，比如go get foo@e3702bed2。关于依赖的版本支持以下几种格式：
gopkg.in/tomb.v1 v1.0.0-20141024135613-dd632973f1e7
gopkg.in/vmihailenco/msgpack.v2 v2.9.1
gopkg.in/yaml.v2 &lt;=v2.2.1
github.com/tatsushid/go-fastping v0.0.0-20160109021039-d7bb493dee3e
latest
replace
在国内访问golang.org/x的各个包都需要翻墙，你可以在go.mod中使用replace替换成github上对应的库。
replace (
    golang.org/x/crypto v0.0.0-20180820150726-614d502a4dac =&gt; github.com/golang/crypto v0.0.0-20180820150726-614d502a4dac
    golang.org/x/net v0.0.0-20180821023952-922f4815f713 =&gt; github.com/golang/net v0.0.0-20180826012351-8a410e7b638d
    golang.org/x/text v0.3.0 =&gt; github.com/golang/text v0.3.0
)
go get
在项目中执行go get命令可以下载依赖包，并且还可以指定下载的版本。

  
  


   
   
运行go get -u将会升级到最新的次要版本或者修订版本(x.y.z, z是修订版本号， y是次要版本号)

   
   
运行go get -u=patch将会升级到最新的修订版本

   
   
运行go get package@version将会升级到指定的版本号version

  
  
如果下载所有依赖可以使用go mod download命令。
整理依赖
我们在代码中删除依赖代码后，相关的依赖库并不会在go.mod文件中自动移除。这种情况下我们可以使用go mod tidy命令更新go.mod中的依赖关系。
go mod edit
格式化
因为我们可以手动修改go.mod文件，所以有些时候需要格式化该文件。Go提供了一下命令：
go mod edit -fmt
添加依赖项
go mod edit -require=golang.org/x/text
移除依赖项
如果只是想修改go.mod文件中的内容，那么可以运行go mod edit -droprequire=package path，比如要在go.mod中移除golang.org/x/text包，可以使用如下命令：
go mod edit -droprequire=golang.org/x/text
关于go mod edit的更多用法可以通过go help mod edit查看。
在项目中使用go module
既有项目
如果需要对一个已经存在的项目启用go module，可以按照以下步骤操作：

  
  


   
   
在项目目录下执行go mod init，生成一个go.mod文件。

   
   
执行go get，查找并记录当前项目的依赖，同时生成一个go.sum记录每个依赖库的版本和哈希值。

  
  
新项目
对于一个新创建的项目，我们可以在项目文件夹下按照以下步骤操作：

  
  


   
   
执行go mod init 项目名命令，在当前项目文件夹下创建一个go.mod文件。

   
   
手动编辑go.mod中的require依赖项或执行go get自动发现、维护依赖。