跳到正文
教程首页
DartCH 12ch12_json

ch12-json

JSON 编解码:dart:convert、json_serializable、健壮错误处理。完整工程共 12 个文件,其中 12 个文本源文件可在下面在线阅读。

12

在线文本文件

1,502

源码行数

dart / yaml / text

语言

19 KB

打包体积

在线阅读源码

左侧按目录浏览,点击文件切换。右上角可复制代码、复制路径或单独下载文件。在线视图只覆盖文本源码,完整工程请下载 zip。

darttextyaml

12 text files · 1,502 lines

dartlib/src/json_basics.dart
/// `dart:convert` 基础:`jsonEncode` / `jsonDecode` 到底产出什么类型。
///
/// JSON 只有 6 种值:object、array、string、number、boolean、null。
/// Dart 把它们映射成:`Map<String, dynamic>`、`List<dynamic>`、`String`、`num`(int/double)、`bool`、`null`。
///
/// 对照 Go:`json.Unmarshal` 到 `map[string]any` 时数字统一是 `float64`(要用
/// `json.Number` 或 struct 才拿到 int);
/// 对照 C:cJSON 用自己的 `cJSON` 结构体树,取值要 `cJSON_GetNumberValue` 并强转。
library;

import 'dart:convert';

/// 编码:任何"可 JSON 化"的 Dart 值 → 字符串。
String encodeJson(Object? value) => jsonEncode(value);

/// 编码成"带缩进"的字符串,调试/日志用。
String encodePretty(Object? value) => const JsonEncoder.withIndent('  ').convert(value);

/// 解码:字符串 → Dart 值(注意返回类型是 `Object?`)。
Object? decodeJson(String raw) => jsonDecode(raw);

/// 解码后各部分的真实类型——用来说明"JSON 是弱类型,Dart 是强类型"。
Map<String, String> decodedTypes(String raw) {
  final Object? value = jsonDecode(raw);
  if (value is! Map<String, Object?>) return <String, String>{'root': value.runtimeType.toString()};

  return <String, String>{
    for (final MapEntry<String, Object?> entry in value.entries)
      entry.key: entry.value.runtimeType.toString(),
  };
}

/// 数值的坑:JSON 只有 "number",Dart 解码时按"有没有小数点"分成 int / double。
///
/// `1` → int,`1.0` → double,`1e3` → double。Go 解码到 `any` 时**全是 float64**,
/// 所以 Go 程序员常以为 "JSON 数字就是 float",在 Dart 里会被 int/double 的区分绊住。
({Object? asInt, Object? asDouble, Object? asExponent}) numberShapes() {
  return (
    asInt: jsonDecode('1'),
    asDouble: jsonDecode('1.0'),
    asExponent: jsonDecode('1e3'),
  );
}

/// 不可编码的类型:DateTime / Set / 自定义对象都会抛 `JsonUnsupportedObjectError`。
///
/// Go 的 `encoding/json` 会把 `time.Time` 编码成 RFC3339;Dart 不会替你转换任何类型。
bool canEncode(Object? value) {
  try {
    jsonEncode(value);
    return true;
  } on JsonUnsupportedObjectError {
    return false;
  }
}

代码构成:dart 33 KB · text 15 KB · yaml 471 B

本地运行

zip → 解压 → 执行
$cd examples/ch12-json && dart pub get && dart run

这个 zip 里有什么

  • • 完整工程目录(含 Android / iOS / 桌面平台脚手架)
  • • lib / bin / test / native 全部源码与测试
  • • pubspec.yaml、锁文件与平台配置文件
  • • 已排除 .dart_tool / build / target / ephemeral 等构建产物

已验证

  • dart analyze 0 告警、dart test 24 个用例全绿
查看全部示例