Question 1

JSONとYAMLの違いは？どちらを使うべきですか？

Accepted Answer

JSON: 厳格な構文（ダブルクォート必須、末尾カンマNG）、機械可読性が高い、全言語でネイティブサポート。API通信・config.json・package.jsonに最適。YAML: 人間が読みやすい（インデント、コメント対応、引用符不要）、Docker Compose・Kubernetes・GitHub Actions・Ansible等の設定ファイルで標準。インデントエラーに注意。使い分け: APIレスポンスはJSON、開発設定ファイルはYAML、ログ出力はJSONが一般的。

Question 2

Kubernetes・Docker ComposeのYAML設定をJSONで書けますか？

Accepted Answer

Kubernetes: `kubectl apply -f`はYAMLとJSON両方に対応。`kubectl get pod my-pod -o json`でJSON出力も可能。Docker Compose: compose.yaml（標準）またはcompose.json（非公式・一部対応）。実用的には: YAML→コメントで設定の説明が書ける→設定ファイルとして推奨。JSON→CI/CDパイプラインでのAPIコールや変数置換が容易。このツールでYAML設定をJSON形式に変換してAPIやスクリプトで処理できます。

Question 3

OpenAPI（Swagger）定義はJSONとYAMLどちらで書くべきですか？

Accepted Answer

OpenAPI 3.0/3.1はYAML・JSON両方をサポート。推奨: YAML（コメントでAPIの説明が書ける、可読性高い、人手でのメンテナンスに向く）。ツール: Swagger Editor・Redoc・Stoplight StudioはYAML/JSON両対応。コードジェネレーター（openapi-generator）もYAML/JSON両方から生成可能。チーム開発: Gitでの差分が見やすいYAMLが多数派。自動生成（プログラムからエクスポート）の場合はJSONが多い。このツールで相互変換してください。

JSON ↔ YAML 変換