JSON vs YAML vs TOML：どの設定フォーマットを使うべき？

JSON、YAML、TOMLはソフトウェア開発で最も人気のある3つの設定フォーマットです。それぞれに異なる強みとトレードオフがあります。このガイドでは、プロジェクトに最適なフォーマットを選ぶための包括的な比較を提供します。

無料ツールで JSON と YAML を即座に変換 →

各フォーマットの概要

JSON（JavaScript Object Notation）

JSONは2000年代初頭にDouglas Crockfordによって導入されました。Web API、package.json、tsconfig.jsonなどのデファクトスタンダードです。

YAML（YAML Ain't Markup Language）

YAMLは2001年に提案され、人間が読みやすいことを目指して設計されました。Docker Compose、Kubernetes、Ansible、CI/CDパイプラインで広く使われています。

TOML（Tom's Obvious Minimal Language）

TOMLは2013年にTom Preston-Wernerによって作られた最小限で曖昧さのない設定フォーマットです。Rust（Cargo.toml）、Python（pyproject.toml）、Hugoの標準です。

構文の比較

同じ設定を3つのフォーマットで表現します：

JSON

{
  "server": {
    "host": "localhost",
    "port": 8080,
    "debug": true
  },
  "database": {
    "host": "db.example.com",
    "port": 5432,
    "name": "myapp",
    "credentials": {
      "username": "admin",
      "password": "secret"
    }
  },
  "features": ["auth", "logging", "cache"],
  "max_connections": 100
}

YAML

# Server configuration
server:
  host: localhost
  port: 8080
  debug: true

# Database settings
database:
  host: db.example.com
  port: 5432
  name: myapp
  credentials:
    username: admin
    password: secret

features:
  - auth
  - logging
  - cache

max_connections: 100

TOML

# Server configuration
max_connections = 100
features = ["auth", "logging", "cache"]

[server]
host = "localhost"
port = 8080
debug = true

[database]
host = "db.example.com"
port = 5432
name = "myapp"

[database.credentials]
username = "admin"
password = "secret"

機能比較

各フォーマットの使いどころ

JSON を使う場合...

// Typical JSON use cases
// package.json
{
  "name": "my-app",
  "version": "1.0.0",
  "scripts": {
    "dev": "next dev",
    "build": "next build"
  }
}

// tsconfig.json
{
  "compilerOptions": {
    "target": "ES2020",
    "module": "ESNext",
    "strict": true
  }
}

YAML を使う場合...

# Docker Compose
services:
  web:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./html:/usr/share/nginx/html

# GitHub Actions
name: CI
on: [push, pull_request]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci
      - run: npm test

TOML を使う場合...

# Cargo.toml (Rust)
[package]
name = "my-app"
version = "0.1.0"
edition = "2021"

[dependencies]
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1", features = ["full"] }

# pyproject.toml (Python)
[project]
name = "my-package"
version = "1.0.0"
requires-python = ">=3.9"

[tool.ruff]
line-length = 88
target-version = "py39"

よくある落とし穴

YAML：インデントの問題

YAMLはインデントで構造を定義します。タブとスペースの混在やインデントレベルの不一致は、最も一般的なエラーの原因です。

# BAD: mixing tabs and spaces (invisible but breaks YAML)
services:
	web:          # tab character - YAML error!
    image: nginx

# BAD: inconsistent indentation
services:
  web:
      image: nginx   # 4 spaces here
    ports:            # 2 spaces here - error!
      - "80:80"

# GOOD: consistent 2-space indentation
services:
  web:
    image: nginx
    ports:
      - "80:80"

YAML：「ノルウェー問題」

YAML 1.1では、引用符なしのNO、yes、on、offはブール値として解釈されます。国コード「NO」（ノルウェー）はfalseになります。

# The "Norway Problem" - YAML 1.1
countries:
  - name: Norway
    code: NO          # Parsed as boolean false!
  - name: Sweden
    code: SE          # Parsed as string "SE"
  - name: Finland
    code: FI          # Parsed as string "FI"

# Other surprising boolean values in YAML 1.1:
truthy:  yes          # boolean true
falsy:   no           # boolean false
enabled: on           # boolean true
disabled: off         # boolean false
positive: TRUE        # boolean true
negative: False       # boolean false

# FIX: Always quote values that could be misinterpreted
countries:
  - name: Norway
    code: "NO"        # Now correctly a string
  - name: Sweden
    code: "SE"
settings:
  enabled: "yes"      # Now correctly a string

JSON：末尾カンマ

JSONは末尾カンマを許可しません。最後の要素の後にカンマを追加するとパースエラーになります。

// BAD: trailing comma after last element
{
  "name": "my-app",
  "version": "1.0.0",
  "private": true,    // <-- trailing comma = PARSE ERROR
}

// BAD: trailing comma in array
{
  "colors": [
    "red",
    "green",
    "blue",            // <-- trailing comma = PARSE ERROR
  ]
}

// GOOD: no trailing commas
{
  "name": "my-app",
  "version": "1.0.0",
  "private": true
}

TOML：ネストされたテーブル構文

TOMLでの深いネスト構造は冗長になることがあります。各レベルに独自の[section.subsection]ヘッダーが必要です。

# TOML: deeply nested config can be verbose
[server]
host = "localhost"

[server.ssl]
enabled = true

[server.ssl.certificates]
cert = "/path/to/cert.pem"
key = "/path/to/key.pem"

[server.ssl.certificates.ca]
bundle = "/path/to/ca-bundle.pem"

# The same in YAML is more compact:
# server:
#   host: localhost
#   ssl:
#     enabled: true
#     certificates:
#       cert: /path/to/cert.pem
#       key: /path/to/key.pem
#       ca:
#         bundle: /path/to/ca-bundle.pem

# TOML inline tables can help for shallow nesting:
[server]
host = "localhost"
ssl = { enabled = true, cert = "/path/to/cert.pem" }

変換ツール

フォーマット間の切り替えが必要ですか？無料オンラインコンバーターをご利用ください：

JSON ↔ YAML コンバーター——双方向変換対応

TOML ↔ YAML コンバーター——即座に変換

無料ツールで JSON と YAML を即座に変換 →

無料ツールで TOML と YAML を変換 →