Go 言語の環境変数管理

Go 1.13 より環境変数の管理の仕方が変わった。

環境変数の設定・削除

まずは go env コマンドで Go 言語関連の環境変数を表示してみる(一部だけね)。 ちなみに私の作業環境は Linux/Ubuntu である。

$ go env
GO111MODULE=""
GOARCH="amd64"
GOBIN=""
GOCACHE="/home/username/.cache/go-build"
GOENV="/home/username/.config/go/env"
GOEXE=""
GOFLAGS=""
GOHOSTARCH="amd64"
GOHOSTOS="linux"
GONOPROXY=""
GONOSUMDB=""
GOOS="linux"
GOPATH="/home/username/go"
GOPRIVATE=""
GOPROXY="https://proxy.golang.org,direct"
GOROOT="/usr/local/go"
GOSUMDB="sum.golang.org"
GOTMPDIR=""
...

たとえば GO111MODULE の値を on にしたければ

$ export GO111MODULE=on

$ go env GO111MODULE
on

などとする。 Go 1.12 まではこれで OK。

Go 1.13 からは go env コマンドに -w オプションを付けて環境変数を設定できる。

$ export -n GO111MODULE

$ go env -w GO111MODULE=auto

$ go env GO111MODULE
auto

また -u オプションで設定を削除できる。

$ go env -u GO111MODULE

$ go env | grep GO111MODULE
GO111MODULE=""

ちなみに shell で設定している環境変数と go env -w コマンドで設定する環境変数が被る場合

$ export GO111MODULE=on

$ go env -w GO111MODULE=auto
warning: go env -w GO111MODULE=... does not override conflicting OS environment variable

$ go env | grep GO111MODULE
GO111MODULE="on"

となり shell 側の設定のほうが優先されるようだ。 一時的な変更の場合は shell 側の環境変数を使えということやね。

環境変数設定の置き場所

go env -w コマンドで設定した環境変数の値は GOENV で指示されるファイルに格納される。 GOENV の既定値は以下の通り(Linux/Ubuntu の場合)。

$ go env GOENV
/home/username/.config/go/env

ちなみに $HOME/.config/ ディレクトリは XDG Base Directory でユーザごとにアプリケーション設定を格納するディレクトリとして規定されている。 また XDG_CONFIG_HOME 環境変数が定義されている場合は,こちらの値が設定ディレクトリとして優先される。

Go 1.13 からは os.UserConfigDir() 関数で XDG Base Directory に対応した設定ディレクトリを取得できる。 os.UserConfigDir() 関数は他のプラットフォームにも対応していて,プラットフォームごとに適切なパスを返すようだ。

// UserConfigDir returns the default root directory to use for user-specific
// configuration data. Users should create their own application-specific
// subdirectory within this one and use that.
//
// On Unix systems, it returns $XDG_CONFIG_HOME as specified by
// https://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html if
// non-empty, else $HOME/.config.
// On Darwin, it returns $HOME/Library/Application Support.
// On Windows, it returns %AppData%.
// On Plan 9, it returns $home/lib.
//
// If the location cannot be determined (for example, $HOME is not defined),
// then it will return an error.
func UserConfigDir() (string, error) {
	var dir string

	switch runtime.GOOS {
	case "windows":
		dir = Getenv("AppData")
		if dir == "" {
			return "", errors.New("%AppData% is not defined")
		}

	case "darwin":
		dir = Getenv("HOME")
		if dir == "" {
			return "", errors.New("$HOME is not defined")
		}
		dir += "/Library/Application Support"

	case "plan9":
		dir = Getenv("home")
		if dir == "" {
			return "", errors.New("$home is not defined")
		}
		dir += "/lib"

	default: // Unix
		dir = Getenv("XDG_CONFIG_HOME")
		if dir == "" {
			dir = Getenv("HOME")
			if dir == "" {
				return "", errors.New("neither $XDG_CONFIG_HOME nor $HOME are defined")
			}
			dir += "/.config"
		}
	}

	return dir, nil
}

以前から os.UserCacheDir() 関数で XDG Base Directory 対応のキャッシュ・ディレクトリは取得可能だったが,これでまたひとつ対応が進んだわけだ。

ブックマーク

参考図書

photo
プログラミング言語Go
アラン・ドノバン (著), ブライアン・カーニハン (著), 柴田芳樹 (著)
丸善出版 2016-06-20 (Release 2021-07-13)
Kindle版
B099928SJD (ASIN)
評価     

Kindle 版出た! 一部内容が古びてしまったが,この本は Go 言語の教科書と言ってもいいだろう。感想はこちら

reviewed by Spiegel on 2021-05-22 (powered by PA-APIv5)