Go 1.27 インタラクティブツアー
Go 1.27 Interactive Tour (victoriametrics.com)
要約
Go 1.27のリリースノートを基にしたハンズオン形式のガイドです。本記事では、メソッド宣言で独自の型パラメータを宣言できるようになったジェネリックメソッド、構造体リテラルで埋め込みフィールドを直接指定できるようになったフィールドセレクタ、そして関数型推論の一般化といった主要な新機能について、実行可能な例を交えて解説します。さらに、メモリ割り当ての高速化、トレースバックでのゴルーチンラベル表示、ゴルーチンリークプロファイル、そしてポスト量子署名(ML-DSA)の実装といった、その他の重要な変更点も紹介しています。
全文翻訳
Go 1.27 インタラクティブツアー
Go 1.27 がリリースされたので、新機能を見ていきましょう。公式リリースノートはかなり簡潔なので、ここでは変更点とその新しい動作がどのように機能するかを示す、実行可能なサンプル付きの実践的なバージョンを提供します。
まず、簡単な謝辞です。インタラクティブな Go ツアーは Anton Zhiyanov によって開始され、彼は Go 1.22 から 1.26 までの各リリースについてツアーを作成しました。彼は作成を終了することにしたため、我々がそのバトンを引き継ぎます。彼の以前のツアーはすべて、今でも読む価値があります。
Anton、ありがとう。
新機能の掘り下げを始める前に、文脈を設定しましょう。
この記事は、公式リリースノートと Go ソースコード(BSD-3-Clause ライセンス)に基づいています。これは網羅的なリストではありません。完全なリストについては、公式リリースノートを参照してください。
リンクは、各機能のドキュメント (𝗗)、提案 (𝗣)、最も関連性の高いコミット (𝗖𝗟)、および作成者 (𝗔) を指しています。動機、使用法、実装の詳細については、それらを確認してください。作成者 (𝗔) は、機能に貢献した人々(実装、テストの作成、または以前の実験から卒業した機能の元の設計の作成)であり、必ずしも単一の主要な作成者ではありません。
エラー処理は、例を短く保つためにしばしば省略されます。本番環境では、これは行わないでください ツ
これはリリースにおける目玉です。メソッド宣言は、レシーバーの型パラメータとは独立して、独自の型パラメータを宣言できるようになりました。Go 1.27 より前は、ジェネリックにできるのはトップレベル関数のみだったため、型のジェネリック操作はメソッドではなくパッケージレベル関数として存在する必要がありました。
ジェネリックコンテナがあり、要素の型を変更できる Map 操作を行いたいとしましょう。
type Box[T any] struct{ v T }
// メソッドは独自の型パラメータ U (Go 1.27 で新規) を宣言します。
func (b Box[T]) Map[U any](f func(T) U) Box[U] {
return Box[U]{v: f(b.v)}
}
これで Map は Box のメソッドになり、int ボックスを string ボックスに変換できます。
func main() {
b := Box[int]{v: 21}
doubled := b.Map(func(n int) int { return n * 2 })
label := doubled.Map(func(n int) string {
return fmt.Sprintf("value=%d", n)
})
fmt.Println(label.v)
}
value=42
重要な制限が1つあります。インターフェースは依然として型パラメータ化されたメソッドを宣言できず、ジェネリックメソッドを使用してインターフェースを満たすことはできません。インターフェースにジェネリックメソッドを配置すると、コンパイラが停止します。
type Mapper interface {
Map[U any](f func(int) U) any // インターフェースはジェネリックメソッドを宣言できません
}
interface method must have no type parameters
- 𝗗 ジェネリックメソッド
- 𝗣 77273
- 𝗖𝗟 524b860, e84da04, e212a16
- 𝗔 Robert Griesemer, Mark Freeman
構造体リテラルのキーは、構造体型の任意の有効なフィールドセレクタになり、トップレベルのフィールド名だけでなく、それも可能になりました。実際には、これは昇格されたフィールド(埋め込まれた構造体から来るフィールド)を、埋め込まれた型を明示的に記述することなく直接設定できることを意味します。
type Base struct {
ID int
}
type User struct {
Base
Name string
}
Go 1.27 より前は User{Base: Base{ID: 7}, Name: "Mittens"} と書く必要がありましたが、今では昇格された ID が単独でキーとして機能します。
u := User{ID: 7, Name: "Mittens"}
fmt.Println(u.ID, u.Name)
7 Mittens
- 𝗗 複合リテラル
- 𝗣 9859
- 𝗖𝗟 1a8f9d8, 9f7e98d, 30bfe53, e2c1885
- 𝗔 Robert Griesemer, Cherry Mui
関数型推論は、ジェネリック関数が一致する関数型が期待されるすべてのコンテキストで適用されるように一般化されました。以前は単純な変数への代入(これは既に機能していました)だけでなく、変換や複合リテラルでも、型引数を手動で指定する必要がありました。
2つのジェネリックヘルパー関数を、要素型が func([]int) int であるスライスにドロップしてみましょう。
func first[T any](s []T) T { return s[0] }
func last[T any](s []T) T { return s[len(s)-1] }
// スライスの要素型が推論を駆動します: 各エントリで T=int。
// Go 1.27 より前は、「cannot use generic function without instantiation」というエラーが発生しました。
// first[int], last[int] と書く必要がありました。
ops := []func([]int) int{first, last}
for _, op := range ops {
fmt.Println(op([]int{10, 20, 30}))
}
10
30
- 𝗗 代入可能性
- 𝗣 77245
- 𝗖𝗟 ef06728, f757de8
- 𝗔 Robert Griesemer, Mark Freeman
コンパイラは、サイズ特化型のメモリ割り当てルーチンへの呼び出しを生成するようになり、一部の小さい(80バイト未満)割り当てのコストを最大30%削減します。パフォーマンスの向上はワークロードによって異なりますが、実際の割り当て負荷の高いプログラムでは、全体的なゲインは約1%になると予想されます。トレードオフとして、ワークロードに関係なく、バイナリサイズが約60KB増加します。
コードを変更する必要はありません。少し速くなるだけです。無効にしたい場合は、GOEXPERIMENT=nosizespecializedmalloc でビルドしてください。このオプトアウトは、Go 1.28 で削除される予定です。
- 𝗗 ランタイムリリースノート
- 𝗣 79286
- 𝗖𝗟 2a93576
- 𝗔 Michael Matloob
go.mod で Go 1.27 以降を設定しているモジュールの場合、トレースバックには、各ゴルーチンのヘッダー行に runtime/pprof のゴルーチンラベルが含まれるようになりました。プロファイリングのために既にラベルを pprof.Do でアタッチしている場合、そのコンテキストがクラッシュダンプ、SIGQUIT トレース、および runtime.Stack の出力にも表示されるようになります(区別が難しい、 otherwise identical なゴルーチンを区別するのに便利です)。
ここでラベルをアタッチし、現在のゴルーチンのスタックをダンプして動作を確認してみましょう。
ctx := context.Background()
pprof.Do(ctx, pprof.Labels("request", "42"), func(ctx context.Context) {
buf := make([]byte, 1<<12)
n := runtime.Stack(buf, false)
fmt.Printf("%s", buf[:n])
})
goroutine 1 [running] {request: 42}:
main.main.func1(...)
.../main.go:14 +0x38
runtime/pprof.Do(...)
.../runtime/pprof/runtime.go:57 +0x8c
main.main()
.../main.go:12 +0x6c
ポインタ引数、オフセット、ファイルパスは実行ごとに異なります。新しいのは、ゴルーチンの [running] 状態の直後に付加される {request: 42} です。これはその pprof ラベルです。同じ {...} アノテーションが、パニックまたは SIGQUIT トレースバック内のすべてのラベル付きゴルーチンのヘッダーに表示されます。GODEBUG=tracebacklabels=0 で無効にできます(この設定は Go 1.26 で追加されました)。ラベルに機密データが含まれており、トレースバックに表示したくない場合のために、このオプトアウトは無期限に維持される予定です。
- 𝗗 runtime/pprof
- 𝗣 76349
- 𝗖𝗟 3694f33, 19c994c
- 𝗔 David Finkel
Go 1.26 では、実験的な機能としてゴルーチンリーク検出器が導入されました。Go 1.27 では、これは通常のプロファイルに昇格しました。runtime/pprof は、GC サイクルを実行して永久にブロックされている(リークした)ゴルーチンを見つけ、そのスタックを報告する goroutineleak プロファイルを提供します。もはや GOEXPERIMENT は必要ありません。
「リークした」ゴルーチンとは、チャネル、ミューテックス、または類似のものに永久にブロックされており、決して進歩する可能性のないゴルーチンのことです。典型的な例は、チャネルに送信するゴルーチンで、そのチャネルは自分だけが保持しており、誰も受信できないというものです。
func leak() {
ch := make(chan int)
ch <- 1 // このゴルーチンだけが ch を参照します
// 送信は永遠にブロックされます: 誰も受信しません
}
1つ開始し、それがパークするのを待ち、その後プロファイルをダンプします。
go leak() // このゴルーチンは決して終了できません
runtime.Gosched() // 送信でパークさせる
// GC バックのスキャンは、決して進歩できないゴルーチンを見つけます。
pprof.Lookup("goroutineleak").WriteTo(os.Stdout, 1)
goroutineleak profile: total 1
1 @ 0x...
# 0x... main.leak+0x27 .../main.go:11
total 1 の行は、検出器が正確に1つのリークしたゴルーチンを見つけたことを示しており、スタックはそのゴルーチンを main.leak にピン留めしています。これは決して完了しない ch <- 1 送信です(アドレスは実行ごとに異なります)。実際のサービスでは、通常、標準出力に書き込む代わりに /debug/pprof/goroutineleak net/http/pprof エンドポイントをスクレイピングします。
- 𝗗 runtime/pprof
- 𝗣 74609
- 𝗖𝗟 253aa2a, 1644917, afcf04c
- 𝗔 Vlad Saioc, Austin Clements, Cherry Mui
新しい crypto/mldsa パッケージは、FIPS 204 で指定されたポスト量子デジタル署名スキームである ML-DSA を実装しています。これは3つのパラメータセット(MLDSA44、MLDSA65、MLDSA87)で提供され、セキュリティレベルと引き換えにキー/署名サイズを調整します。
priv, _ := mldsa.GenerateKey(mldsa.MLDSA65())
msg := []byte("victoria metrics")
sig, _ := priv.Sign(rand.Reader, msg, crypto.Hash(0))
fmt.Println("scheme: ", mldsa.MLDSA65())
fmt.Println("sig size:", mldsa.MLDSA65().SignatureSize())
fmt.Println("verified:", mldsa.Verify(priv.PublicKey(), msg, sig, nil) == nil)
scheme: ML-DSA-65
sig size: 3309
verified: true
ML-DSA サポートは、crypto/x509(秘密鍵、公開鍵、署名)および crypto/tls(TLS 1.3 の新しい MLDSA44、MLDSA65、MLDSA87 署名スキーム)にも及びます。
- 𝗗 crypto/mldsa
- 𝗣 77626
- 𝗖𝗟 7bc111c
- 𝗔 Filippo Valsorda, Daniel McCarney
Go についに標準ライブラリに UUID パッケージが追加されました。新しいトップレベルの uuid パッケージは、RFC 9562 に従って UUID を生成および解析し、暗号学的に安全な乱数ソースを使用します。ランダムコンポーネントの UUID は比較可能なので、直接 == を使用できます。
a := uuid.MustParse("f81d4fae-7dec-11d0-a765-00a0c91e6bf6")
fmt.Println("parsed:", a)
fmt.Println("nil: ", uuid.Nil())
fmt.Println("max: ", uuid.Max())
parsed: f81d4fae-7dec-11d0-a765-00a0c91e6bf6
nil: 00000000-0000-0000-0000-000000000000
max: ffffffff-ffff-ffff-ffff-ffffffffffff
生成に関しては、uuid.New() はほとんどの用途に適したアルゴリズムを選択し、uuid.NewV4() は純粋なランダム UUID を、uuid.NewV7() は時間順の UUID を生成します。後者はデータベースキーとして、作成時間でソートできるため非常に便利です。各呼び出しは新しい値を生成するので、これを数回実行してみてください。
fmt.Println(uuid.NewV4()) // ランダム
fmt.Println(uuid.NewV7()) // 時間順
- 𝗗 uuid
- 𝗣 62026
- 𝗖𝗟 2fb2b98
- 𝗔 Damien Neil
待望の encoding/json/v2 リライトは、Go 1.25 から実験的なものでした。Go 1.27 では、この実験が卒業し、encoding/json/v2 とその低レベルのコンパニオンである encoding/json/jsontext が GOEXPERIMENT=jsonv2 ビルドフラグなしで利用可能になりました。より静かですが、より大きな変更点として、従来の encoding/json (v1) パッケージが、内部的には v2 の実装によってバックアップされるようになりました。
切り替えは透過的です。動作は保持されており(一部のエラーメッセージテキストのみが異なります)、新しい オプション を使用して、v2 を v1 のセマンティクスにピン留めすることで、それらが逸脱するのを防ぎます。移行は不要で、互換性の問題が発生した場合は GOEXPERIMENT=nojsonv2 で元の v1 実装に戻すことができます。
一般的なケースでは、v2 API は v1 をミラーリングします(ここでのインポートは json "encoding/json/v2" です)。
type Point struct {
X int `json:"x"`
Y int `json:"y"`
}
data, err := json.Marshal(Point{X: 1, Y: 2})
fmt.Println(string(data), err)
{"x":1,"y":2} <nil>
知っておくと良い動作が1つあります。v1 は常にマップキーをソートしていましたが、v2 はデフォルトではソートしません。ソートをスキップすると、より高速になります。安定したマップ出力が必要な場合(例えば、ゴールデンテスト用)、json.Deterministic オプションを渡します。
- 𝗗 encoding/json/v2
- 𝗣 71497
- 𝗖𝗟 e62d3e6
- 𝗔 Joe Tsai, Damien Neil
Go 1.27 は、実験的な simd パッケージを追加しました。これは、ポータブルで、ベクトルサイズに依存しない SIMD で、利用可能な場合は実際のハードウェアベクトル命令にコンパイルされ、そうでない場合は純粋な Go エミュレーションにフォールバックします。デフォルトではオフになっており、GOEXPERIMENT=simd でビルドすると有効になります。
型名は要素型の後に s を付けた名前です(Int32s、Float32s、Float64s など)。幅は意図的に固定されていません。Float32s は、あるマシンでは4レーン、別のマシンでは16レーンになる可能性があります。ベクトルをスライスからロードし、操作してから、再びストアします。ハードウェアが幅を選択します。
a := []float32{1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16}
b := []float32{10, 20, 30, 40, 50, 60, 70, 80, 90, 100, 110, 120, 130, 140, 150, 160}
va := simd.LoadFloat32s(a) // a から va.Len() レーンを正確に読み込みます
vb := simd.LoadFloat32s(b)
sum := va.Add(vb) // 要素ごとの加算、1つの命令で多数のレーンを処理
out := make([]float32, sum.Len())
sum.Store(out)
fmt.Println(out[:4])
[11 22 33 44]
- 𝗗 simd
- 𝗣 78902
- 𝗖𝗟 44a4be9, 8d29cf2, 48bf922
- 𝗔 David Chase, Junyang Shao, Cherry Mui
strings.Cut(Go 1.18 から)は、区切り文字の最初の出現箇所で文字列を分割します。Go 1.27 では、最後の出現箇所のために strings.CutLast(および bytes.CutLast)が追加されました(多くの LastIndex のダンスをよりクリーンに置き換えます)。
before, after, found := strings.CutLast("a/b/c", "/")
fmt.Printf("%q %q %v\n", before, after, found)
before, after, found = strings.CutLast("nosep", "/")
fmt.Printf("%q %q %v\n", before, after, found)
"a/b" "c" true
"nosep" "" false
Cut と同様に、区切り文字が見つからない場合、before には入力全体、after には空文字列、found は false になります。
- 𝗗 strings.CutLast, bytes.CutLast
- 𝗣 71151
- 𝗖𝗟 11b596c
- 𝗔 qiulaidongfeng
hash/maphash パッケージに Hasher[T] インターフェースが追加されました。これは、将来のハッシュベースのデータ構造(ハッシュテーブル、ブルームフィルタなど)が型の値のハッシュ化と比較に使用できる契約です。これは2つの操作をバンドルします:実行中のハッシュに値を混合する Hash と、2つの値を比較する Equal です。それらを結びつけるルールは、等しい値は同じハッシュを持つ必要があるということです。比較可能な型すべてに対して、すぐに使える ComparableHasher[T](値によるハッシュ、== による等価性)がありますが、興味深いのは独自の定義です。ここでは、大文字小文字を区別しない文字列ハッシュの例を示します。
type ciHasher struct{}
// 両方のメソッドは同じように正規化されます(小文字化)。そのため、
// Equal な値は常に同じハッシュを持ちます。
func (ciHasher) Hash(h *maphash.Hash, s string) { h.WriteString(strings.ToLower(s)) }
func (ciHasher) Equal(x, y string) bool { return strings.ToLower(x) == strings.ToLower(y) }
両方のメソッドは同じ正規形に合意する必要があります。これは、見た目よりも間違えやすいことです。Equal を strings.EqualFold として記述すると、より自然に見えますが、契約を静かに破ることになります。EqualFold は単純な大文字小文字の折り畳みを実装していますが、これは ToLower が生成する関係ではありません。EqualFold("ſ", "s") は true(U+017F、ロングエス、s に折り畳まれる)ですが、ToLower は ſ を変更しないため、2つの文字列は等しくなり、異なるハッシュになります(マイクロ記号 µ とギリシャ文字 μ も同様です)。Go のドキュメントでさえ、かつてはこれら2つが同等であると主張していましたが、#52204 でそれがそうではないことが指摘されるまでそうでした。
これで `