この実験では、Go における依存関係の管理方法である GOPATH と Go Modules について学びます。これらは、Go プロジェクトを効果的に組織化して管理するための重要な概念です。
学習ポイント：
このステップでは、提供された tarball を解凍することで環境を準備します。
まず、ターミナルを開き、以下を入力してプロジェクトディレクトリに移動します。
cd ~/project現在のディレクトリにあるhelloWorld.tar.gzファイルを解凍します。
tar -xzf helloWorld.tar.gzファイルが抽出された後、helloWorldフォルダが作成されたかどうかを確認します。
ls helloWorldこれは、helloWorldディレクトリが正しく解凍された場合、その内容を一覧表示します。
Go 1.11 以前は、Go はすべての Go コードを格納するためにGOPATHと呼ばれる特定のワークスペースを使用していました。このステップでは、GOPATH がどのように機能するかを理解します。
GOROOTは、Go がインストールされているディレクトリであり、そのツールや標準ライブラリパッケージも含まれています。GOPATHは、あなたの個人的な Go コードが存在する場所であり、3 つのディレクトリが含まれています。
現在のGOPATHとGOROOTを確認するには、次のコマンドを実行します。
## GOPATHディレクトリを確認する
go env | grep GOPATH
## GOROOTディレクトリを確認する
go env | grep GOROOTこれらのコマンドは、あなたのマシン上のGOPATHとGOROOTのパスを表示します。
Go 1.11 で導入され、Go 1.13 ではデフォルトで有効になった Go Modules は、2 つの主要な問題を解決することを目的としています。
GOPATH/srcディレクトリ内に保存する必要がありました。Go Modules を使用することで、コードをシステム内の任意の場所に保存できます。このステップでは、新しいプロジェクトに対して Go Module を初期化します。
testHelloという名前の新しいプロジェクト用のディレクトリを作成します。
cd ~/project
mkdir testHellotestHelloディレクトリに移動します。
cd testHelloこのプロジェクト用の Go Module を初期化します。
go mod init testHello出力は以下のようになるはずです。
go: creating new go.mod: module testHellotestHelloフォルダ内に新しい Go ファイルtestHello.goを作成し、以下の内容を記述します。
touch testHello.gopackage main
import "fmt"
func main() {
fmt.Println("hello, world")
}これで、Go Modules を使ってtestHelloプロジェクトを初期化し、簡単な Go プログラムを追加しました。
このステップでは、Go プロジェクトで他のモジュールをインポートして使用する方法を示します。
helloWorldフォルダ内のhelloWorldパッケージは Go Modules で初期化されています。同様に、Go Modules を使用するtestパッケージは、helloWorldパッケージからSay関数をインポートしています。
これを調べるには、次のコマンドを実行します。
まず、helloWorldとtestディレクトリの構造を見てみましょう。
helloWorld
├── go.mod
└── helloWorld.go
test
├── go.mod
└── test.go次に、test/go.modファイルを開きます。以下のように表示されるはずです。
module test
go 1.15
require "helloWorld" v0.0.1
replace "helloWorld" => "../helloWorld"replaceディレクティブは、Go に対して外部リポジトリから取得する代わりに、ローカルパス../helloWorldを使用するように指示します。requireディレクティブは、testパッケージがhelloWorldパッケージのv0.0.1バージョンに依存していることを指定します。
| パラメータ | 説明 |
|---|---|
| module | パッケージを指定します |
| require | 依存関係を指定します |
| replace | 依存関係を置き換えます |
| exclude | 依存関係を除外します |
testパッケージ内のtest.goファイルを実行するには：
cd ~/project/test
go run test.go出力は以下のようになるはずです。
hello, worldGo では、リモートパッケージを簡単にインポートできます。GitHub からのリモートパッケージを使用してこれを示しましょう。
remoteModuleディレクトリを作成します。
cd ~/project
mkdir remoteModule
cd remoteModuleGo Module を初期化します。
go mod init remoteModuleremoteModuleフォルダ内にremote.goという名前のファイルを作成し、以下の内容を記述します。
touch remote.gopackage main
import (
"github.com/labex-labs/golang-dev-code/chap02module"
)
func main() {
chap02module.StringTobase64("miiy")
}このプログラムは GitHub からchap02moduleパッケージをインポートし、そのStringTobase64関数を使用しています。
以下のコマンドを使用してremote.goファイルを実行します。
go get github.com/labex-labs/golang-dev-code/chap02module
go run -v remote.goヒント：無料ユーザーはインターネットにアクセスできないため、このコマンドを実行できません。インターネットにアクセスするには、Pro プランにアップグレードしてください。
go getコマンドは GitHub からchap02moduleパッケージをダウンロードし、モジュールキャッシュに配置します。完了すると、go runコマンドがプログラムを実行します。
このステップでは、リモートモジュールのHello関数を使用する新しいファイルを作成することで、私たちの知識をテストします。
remoteModule2フォルダを作成します。
cd ~/project
mkdir remoteModule2
cd remoteModule2Go Module を初期化します。
go mod init remoteModule2以下の内容を持つremote2.goファイルを作成します。
touch remote2.gopackage main
import (
"github.com/labex-labs/golang-dev-code/chap02module"
)
func main() {
chap02module.Hello()
}プログラムを実行します。
go get github.com/labex-labs/golang-dev-code/chap02module
go run remote2.go出力は以下のようになるはずです。
helloこの実験では、以下のことを学びました。
GOPATH と GOROOT ディレクトリの意味と目的この実験が終了するまでに、Go プロジェクトで依存関係を管理するために Go Modules を使いこなせるようになっているはずです。
