概要

• Go 1.25で新たに導入された encoding/json/v2 と encoding/json/jsontext パッケージの紹介
• 既存の encoding/json パッケージの課題とその解決策の提案
• jsontext パッケージの役割とAPI概要
• v2パッケージの開発背景とコミュニティ主導の経緯
• 新APIの利用方法と今後の展望

GoのJSON対応の進化：encoding/json/v2とjsontextの登場

• JSON はインターネット上で最も広く使われるデータフォーマットであり、Go言語でも多く利用される現状
• 既存の encoding/json （v1）は柔軟性が高い一方、標準化やセキュリティ、パフォーマンス面で多くの課題
  • 無効なUTF-8の許容や、重複メンバー名の処理不備
  • nilスライス・マップの扱い、ケース非依存のフィールド解決
  • メソッド呼び出しの不整合、APIの使い勝手の悪さ
  • ストリーミング処理の非効率性やメモリ消費
• 既存APIの後方互換性維持のため、直接の修正が困難
  • 新バージョンとして encoding/json/v2 の開発を決断
• v2の計画は5年以上にわたり、Goコミュニティ主導で進行
  • Daniel MartíやJoe Tsaiらによる設計・実装
  • GopherConでの発表や公開ミーティング、提案文書を経てGo 1.25で実験的導入

jsontextパッケージの基礎とAPI概要

• jsontext はJSONの構文レベルの処理専用パッケージ
  • 構文（エンコード/デコード）と意味（マシャル/アンマシャル）を明確に分離
• 主な型と関数
  • Encoder/Decoder ：io.Writer/io.Readerベースでストリーミング処理
    • NewEncoder(io.Writer, ...Options) *Encoder
    • NewDecoder(io.Reader, ...Options) *Decoder
  • Value 型：JSON値の[]byte表現（v1のRawMessageと同等）
  • Token 型：JSONトークンの効率的な表現（アロケーション削減設計）
• オプション による動作カスタマイズが可能
• v1とは異なり、構文と意味付けを混同せず、純粋なストリーミング処理を実現

v2 APIの特徴と改善点

• MarshalJSONTo/UnmarshalJSONFrom インターフェースでストリーミング指向の拡張
  • これによりバリデーションやフォーマット調整の責任をEncoder/Decoderに分離
• v1の既存問題（パフォーマンス、セキュリティ、カスタマイズ性）を根本から解決
• v1からv2への移行も容易に設計、既存ユーザーへの配慮

今後の展望とコミュニティへの呼びかけ

• encoding/json/v2 と jsontext は実験的な段階であり、API変更の可能性あり
• 広範なユーザーテストとフィードバックを通じて安定版へ発展予定
• Google以外の開発者主導で進化するGoエコシステムの象徴例

---

Go 1.25以降、 encoding/json/v2 と jsontext の活用により、より安全で高速・柔軟なJSON処理が可能となる。今後もコミュニティの参加とフィードバックが、GoのJSONエコシステムの進化を後押しする。