Dart/Flutter中如何获取第三方提供的类或实例的结构与属性信息

你之前用print(实例.toString())看到的精简输出，是对应类开发者主动覆写toString()方法生成的摘要信息，不等同于类的全部可访问属性列表——这也是你看到的Position类输出只包含经纬度、和实际属性名不一致的核心原因。

适配Flutter生态的快速调试方法 #

• 你用到的geolocator插件返回的Position类本身就内置了toJson()方法，绝大多数Flutter平台交互类（传感器、相机、系统通道返回的数据类）都支持该方法，可以直接配合JSON格式化输出完整属性：

import 'dart:convert';
// 以检视Position实例为例，输出带缩进的结构化全属性
const encoder = JsonEncoder.withIndent('  ');
print(encoder.convert(position.toJson()));

• 这种方式可以一次性输出该实例存储的所有属性值，包括定位精度、获取时间戳、海拔、航向这类你没留意的字段，输出的结构和JS控制台展开对象的效果一致。

零代码检视所有属性的调试技巧 #

• 在Android Studio/VS Code中启动调试模式运行程序，在代码对应位置打上断点，程序触发断点后，直接在调试面板的变量列表栏找到目标实例，IDE会自动递归展开实例的所有可访问属性，包括公开属性、私有字段、嵌套对象的内部值，不需要提前写任何转换代码，哪怕是第三方包提供的未公开类也能完整检视。
• 这是日常开发中效率最高的属性查阅方式，完全不需要靠代码补全提示猜属性的含义。

全场景通用的反射方案（注意使用限制） #

• 如果需要在日志里直接输出任意自定义类的全属性，不依赖类本身实现的toJson方法，可以用Dart的镜像反射库动态遍历类的所有实例属性：

import 'dart:convert';
import 'dart:mirrors';

Map<String, dynamic> dumpInstanceProps(dynamic instance) {
  final instanceMirror = reflect(instance);
  final props = <String, dynamic>{};
  // 遍历类的所有声明，筛选非静态的实例变量
  instanceMirror.type.declarations.forEach((symbol, declaration) {
    if (declaration is VariableMirror && !declaration.isStatic) {
      final propName = MirrorSystem.getName(symbol);
      props[propName] = instanceMirror.getField(symbol).reflectee;
    }
  });
  return props;
}

// 使用时直接传入目标实例即可
print(const JsonEncoder.withIndent('  ').convert(dumpInstanceProps(snapshot.data)));

• 注意使用限制：该方案仅适用于纯Dart VM运行环境（如本地测试脚本、单元测试），Flutter Release打包时会通过Tree Shaking裁剪反射相关的代码，运行时会直接抛错，仅适合开发阶段临时调试使用。

内容的提问来源于stack exchange，提问作者weekend_lover