---
source_url: https://go.dev/blog/jsonv2
source_title: "A new Go API for JSON - The Go Programming Language"
hero_image: https://go.dev/doc/gopher/runningsquare.jpg
tags: json,go,encoding,standard-library,serialization
generated_at: 2026-11-04T20:01:01.969Z
model: claude-haiku-5-5
---
# Go の新しい JSON API「encoding/json/v2」、Go 1.27 で正式提供へ

Go の encoding/json/v2 と encoding/json/jsontext パッケージは、Go 1.27 で安定版かつ一般提供される。Go 1.25 で実験的に導入された後、v1 の動作上の欠陥や API の不備、性能面の制約への対応を重ねてきた。

The Go Programming Language Blog は2026年11月4日付の記事で、encoding/json/v2 と encoding/json/jsontext パッケージが Go 1.27 で安定版となり、一般提供されると伝えた。両パッケージは、encoding/json の動作上の欠陥、API の不備、性能上の制約を改善する実験として始まったものである。

![記事掲載の API 関連画像](https://go.dev/blog/jsonv2/api.png)

## 開発の経緯

2020年末、Daniel Martí が仮想的な v2 パッケージのあるべき姿に関する考えを初めて書き起こした。その後 Daniel Martí と Joe Tsai が v2 について意見を出し合い、プロトタイプの開発を始めた。記事は、v2 の取り組みがここまでに約6年を要したとしている。

記事では、Go ブログが JSON サポートについて初めて書いたのは15年以上前だったとも触れられている。プロジェクトに関わった人物として、Michael Pratt、Joe Tsai、Daniel Martí、Johan Brandhorst-Satzkorn、Roger Peppe、Chris Hines、Damien Neil、Austin Clements、Anton Zhiyanov の名前が挙げられている。

## v2 の主な動作変更

v2 では、従来の encoding/json と比べて次の点が変わる。

- 不正な UTF-8 を含む場合、v2 はエラーを報告する。現行の encoding/json は不正な UTF-8 を受け付ける。
- JSON オブジェクトに重複したメンバー名がある場合、v2 はエラーを報告する。現行の encoding/json は重複メンバー名を受け付ける。
- nil の Go スライスと Go マップは、それぞれ空の JSON 配列と空の JSON オブジェクトとしてマーシャルされる。
- JSON オブジェクトから Go 構造体へのアンマーシャルでは、JSON メンバー名と Go フィールド名の照合が大文字小文字を区別する形で行われる。
- time.Duration をシリアライズしようとするとエラーを報告する。

記事は、重複メンバー名を悪用された脆弱性として CVE-2017-12635 を挙げ、JSON の文法の根拠として RFC 8259 を引いている。

## 性能

記事によると、v2 のアンマーシャル性能は v1 より大幅に高速であり、ベンチマークでは最大 10x の改善が示されている。マーシャルの性能は v1 とほぼ同等である。また、v1 は内部的に v2 を用いて実装されている。

Go 1.28 では、さらなる性能改善が見込まれているという。

![記事掲載の API 関連画像](https://go.dev/blog/jsonv2/api.png)

## 筆者の見立て

- 筆者は、v2 の取り組みが約6年を要したことについて、フィードバックと実際の経験を取り入れることの価値を示すと論じている。
- 筆者は、このプロジェクトが Google に雇用されていない人々によって主に開発・推進されている点に触れ、Go プロジェクトが世界的なコミュニティに支えられた共同の取り組みであることを示すと解釈している。

*この記事は元記事の事実のみに基づいて自動生成されました。*

## 出典

- 媒体名: The Go Programming Language Blog
- 原題: A new Go API for JSON - The Go Programming Language
- URL: https://go.dev/blog/jsonv2
- (Anton Zhiyanov's blog、kubernetes/kube-openapi#315、go-json-experiment/jsonbench repository、RFC 8259、CVE-2017-12635) の報道による
