Go言語で文字列をJSONに含めるときのエスケープ処理を初心者向けに解説

先生と生徒の会話形式で理解しよう

生徒

「Goで文字列をJSONに変換するとき、エスケープって必要ですか？」

先生

「はい、必要です。JSONは文字列の中で特定の文字、例えばダブルクォートやバックスラッシュを特別扱いします。そのまま文字列を入れるとJSONの構造が壊れてしまうことがあります。」

生徒

「なるほど。じゃあ、Goではどうやって安全にJSONに文字列を入れるんですか？」

先生

「Goでは標準パッケージのencoding/jsonを使うと、自動でエスケープしてくれます。手動で行う必要はほとんどありません。」

生徒

「自動でやってくれるなら安心ですね。でも、どんな文字がエスケープされるんですか？」

先生

「JSONでエスケープされる代表的な文字は、ダブルクォート、バックスラッシュ、改行、タブなどです。例えば文字列に\"や\nが含まれている場合、自動的に\\\"や\\nに変換されます。」

1. Go言語で文字列をJSONに変換する基本

Go言語で文字列をJSONに含めるには、標準パッケージのencoding/jsonにあるMarshal関数を使うのが基本です。 JSONは「""」のようなダブルクォートや、\（バックスラッシュ）、改行などを特別な意味として扱うため、手書きでJSON文字列を作ると壊れやすいです。しかしMarshalに任せれば、必要なエスケープ処理を自動で行い、正しいJSON形式の文字列に変換してくれます。初心者の方は「安全なJSON文字列を作る道具」と覚えると理解しやすいです。

たとえば、文章の中にダブルクォートが入っているケースや、改行を含むメッセージを送るケースはよくあります。そのままJSONに入れると区切りが崩れてエラーになりますが、Marshalを使うと自動的に整えてくれるので安心です。まずは短い文字列で動きを確認してみましょう。


package main

import (
    "encoding/json"
    "fmt"
)

func main() {
    // JSONに入れたい元の文字列（ダブルクォートと改行を含む）
    str := "Go言語で\"JSON\"を扱う\n例です"

    // MarshalでJSON形式に変換（必要なエスケープは自動）
    jsonData, _ := json.Marshal(str)

    // 変換後のJSON文字列を表示
    fmt.Println(string(jsonData))
}


"Go言語で\"JSON\"を扱う\n例です"

出力を見ると、文字列の中のダブルクォートが\"、改行が\nとして表現されています。これは「JSONとして安全に読める形」に変換された結果です。このように、Go言語でJSON変換をするときは、文字列をそのまま連結して作るのではなく、Marshalで整形してから扱うのが基本になります。


package main

import (
    "encoding/json"
    "fmt"
)

func main() {
    // もっと短い例（初心者向け）
    msg := "こんにちは\"Go\""
    b, _ := json.Marshal(msg)
    fmt.Println(string(b))
}

短い例でも同じように、ダブルクォートが自動でエスケープされます。まずは「文字列をJSONに変換すると、必要な記号が自動で置き換わる」という感覚をつかむと、JSON出力やAPI送信の場面でも迷いにくくなります。

2. 構造体とJSONの組み合わせ

複数のデータをまとめてJSONに変換したいときは、Go言語の「構造体」を使うのが定番です。構造体は、名前やコメントのように種類の違う情報をひとつの箱に整理して持てる仕組みで、 JSONにするときも「項目名」と「値」のセットとして分かりやすい形にできます。さらに、構造体の文字列フィールドにダブルクォートや改行が含まれていても、json.Marshalが自動でエスケープしてくれるので安心です。

下の例では、Personという構造体に「名前」と「コメント」を入れてJSONへ変換しています。 `json:"name"` のようなタグは、JSONにしたときの項目名を決めるための目印です。これを付けておくと、Goのフィールド名が英語でも日本語でも、出力するJSONの形を揃えやすくなります。初心者の方は「JSONのラベルを付けるシール」くらいの感覚で大丈夫です。


package main

import (
    "encoding/json"
    "fmt"
)

type Person struct {
    Name    string `json:"name"`
    Comment string `json:"comment"`
}

func main() {
    p := Person{
        Name:    "太郎",
        Comment: "Go言語は\"便利\"です\n初心者にも優しい",
    }

    jsonData, _ := json.Marshal(p)
    fmt.Println(string(jsonData))
}


{"name":"太郎","comment":"Go言語は\"便利\"です\n初心者にも優しい"}

出力結果では、コメント内のダブルクォートが\"に、改行が\nになっているのが分かります。つまり「人が読める文章」を入れても、JSONとして壊れない形に整えてくれるということです。このように構造体を使うと、プロフィール情報やフォーム入力、メッセージ内容などを安全にJSON化できるため、 Web APIの送受信やログ保存でも使いやすい形になります。


package main

import (
    "encoding/json"
    "fmt"
)

type Person struct {
    Name    string `json:"name"`
    Comment string `json:"comment"`
}

func main() {
    // もっと短い例（初めての人向け）
    p := Person{Name: "花子", Comment: "よろしくお願いします"}
    b, _ := json.Marshal(p)
    fmt.Println(string(b))
}

まずは短い例で「構造体を作る → MarshalでJSONにする → 表示する」という流れに慣れると、複数項目のデータを扱う場面でも迷いにくくなります。構造体とJSONの組み合わせは、Go言語のデータ変換で特によく使う基本パターンです。

3. JSONエスケープの重要性

文字列をそのままJSONに含めると、JSONの形が崩れてエラーになったり、受け取った側で正しく読み取れないことがあります。 JSONではダブルクォートやバックスラッシュが「区切り」や「特別な記号」として扱われるため、文章の中にそれらが入っていると、意図しない場所で文字列が終わったように見えてしまうからです。さらに改行やタブのような制御文字も、見た目では分かりにくいのにJSONの解釈に影響するので注意が必要です。

たとえば、次のように文字列を自分でつないでJSONを作ると、一見それっぽく見えても壊れやすくなります。初心者の方ほど「これで動きそう」と感じやすい書き方ですが、ダブルクォートが混ざった瞬間に失敗しやすいです。だからこそ、Go言語ではjson.Marshalを使ってエスケープを含めた整形を任せるのが安全です。


package main

import "fmt"

func main() {
    // ありがちな手作業の例（JSONが壊れやすい）
    msg := "Goは\"速い\"です"
    badJSON := "{ \"message\": \"" + msg + "\" }"
    fmt.Println(badJSON) // 見た目はJSONっぽいが、実際は崩れやすい
}

この例では、msgの中にあるダブルクォートがそのまま入るため、JSONとして読む側は途中で区切りが終わったと勘違いしやすくなります。こうしたトラブルは、API通信や設定ファイル、ログ出力など、JSONを使う場面でよく起きます。そのため、ダブルクォート、改行、バックスラッシュを含む可能性がある文字列は、必ずMarshalでエスケープ処理を行ってからJSONに含めるのが基本になります。

Go言語を基礎からスッキリ学びたい人や、文法だけでなく「実用的な使い方」まで押さえたい人には、定番の入門書がこちらです。

基礎からわかるGo言語をAmazonで見る

※ Amazon広告リンク

4. エスケープ処理の手動操作

通常はMarshalで自動処理されますが、文字列だけをエスケープしたい場合はjson.HTMLEscapeやjson.Marshalでバイトスライスに変換して操作する方法もあります。これは高度な操作ですが、特殊文字の処理をカスタマイズしたい場合に便利です。

5. 実務での活用ポイント

API通信やファイル保存などでJSONを扱う際、文字列のエスケープを意識することは重要です。Go言語のencoding/jsonパッケージを使えば、エスケープ処理を自動で行えるため、安全にデータをやり取りできます。また、文字列を直接結合してJSONを作るのは避け、必ずMarshalを使う習慣をつけましょう。

まとめ

Go言語でJSONと文字列を安全に扱うための振り返り

ここまで、Go言語で文字列をJSONに含めるときに必要となるエスケープ処理について、基礎から実務での考え方まで順を追って学んできました。 JSONは非常に便利なデータ形式ですが、文字列の扱いを誤ると、構造が壊れてしまったり、プログラムが正しく動作しなくなる原因になります。特にダブルクォートやバックスラッシュ、改行文字などはJSONの構文に直接影響するため、正しいエスケープ処理が欠かせません。

Go言語では、encoding/json パッケージを利用することで、こうしたエスケープ処理を自動的に行えます。 json.Marshal を使えば、文字列や構造体のフィールドに含まれる特殊文字を意識することなく、安全にJSON形式へ変換できます。初心者の方が最初につまずきやすい「JSON文字列の中にダブルクォートを入れたらエラーになる」といった問題も、標準パッケージを正しく使うことで簡単に回避できます。

また、構造体とJSONを組み合わせることで、複数のデータをまとめて扱える点も重要なポイントです。名前やコメント、説明文など、文字列を多く含むデータでも、Marshal を使えば一貫した形式でJSONに変換できます。文字列を手作業で連結してJSONを作成する方法は、一見簡単に見えてもエスケープ漏れやバグの原因になりやすいため、実務では避けるべき書き方だということも理解しておきましょう。

エスケープ処理を意識したサンプルプログラム


package main

import (
    "encoding/json"
    "fmt"
)

type Message struct {
    Title   string `json:"title"`
    Content string `json:"content"`
}

func main() {
    msg := Message{
        Title:   "Go言語のJSON",
        Content: "JSONでは\"文字列\"や\n改行の扱いに注意が必要です",
    }

    jsonData, _ := json.Marshal(msg)
    fmt.Println(string(jsonData))
}

このサンプルでは、構造体の中にダブルクォートや改行を含む文字列を定義していますが、 json.Marshal を使うことで正しくエスケープされたJSONが生成されます。プログラマが個別にエスケープ処理を書く必要がないため、コードの見通しが良くなり、保守性も向上します。 API通信や設定ファイルの出力など、JSONを扱う場面では必須の考え方と言えるでしょう。

さらに、HTMLを含む文字列を扱う場合や、より細かく制御したい場合には json.HTMLEscape などの補助的な関数も存在します。ただし、通常のWeb APIや業務システム開発においては、まず Marshal を正しく使えるようになることが最優先です。基本を押さえた上で、必要に応じて高度なエスケープ処理を学んでいくと、無理なく理解が深まります。

先生と生徒の振り返り会話

生徒

「JSONに文字列を入れるだけなのに、エスケープを意識しないといけない理由がよく分かりました。特にダブルクォートがそのままだと壊れるのは怖いですね」

先生

「そうですね。でもGo言語では標準の encoding/json を使えば、その心配をほとんどしなくていいのが大きな利点です」

生徒

「構造体に文字列を入れて Marshal するだけで、自動的にエスケープされるのはとても安心できました」

先生

「実務では、その安心感がとても大切です。 JSONを手で組み立てるより、必ずライブラリに任せる癖をつけてください」

生徒

「API通信やファイル保存でも同じ考え方が使えそうですね。これからは文字列の扱いに気をつけます」

先生