萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

服務端拼接 JSON 字串正確姿勢:StringBuilder.Append 而非 AppendFormat

錯誤示範

StringBuilder sb = new StringBuilder();
sb.AppendFormat("{{\"id\":{0},\"name\":\"{1}\"}}", id, name); // 錯誤!大括號與格式項目衝突

AppendFormat 將 { } 視為格式佔位符,JSON 本身含大括號導致 FormatException。

正確做法:StringBuilder.Append

StringBuilder sb = new StringBuilder();
sb.Append("{\"id\":").Append(id).Append(",\"name\":\"").Append(name).Append("\"}");

或使用字串插值 (C# 6+):

string json = $"{{\"id\":{id},\"name\":\"{name}\"}}"; // 雙大括號轉義

最佳實務:使用序列化庫

// Newtonsoft.Json
string json = JsonConvert.SerializeObject(new { id, name });

// System.Text.Json (.NET Core 3.0+)
string json = JsonSerializer.Serialize(new { id, name });
  • 自動處理逸出字元、日期格式、巢狀物件。
  • 避免手工拼接導致 XSS/注入風險。
  • 效能優於手工 StringBuilder (內部同樣用 Utf8JsonWriter)。

何時仍需手工拼接?

  • 極簡單、固定結構、零相依專案 (如輕量 HTTP Handler)。
  • 需產生非標準 JSON (如 Legacy 系統要求尾隨逗號)。

結論

手工拼接 JSON 易出錯且難維護,永遠優先使用成熟序列化庫;若必須手工,請用 StringBuilder.Append 或字串插值,切勿使用 AppendFormat。

copyright © 萬盛學電腦網 all rights reserved