将Directory.list()返回的FileEntity转为字符串时遇异常问题

为什么File.toString()无法返回纯路径？ #

Dart的File类继承自FileSystemEntity，它的toString()方法并非设计用来返回可直接使用的纯文件路径。这个方法的核心作用是提供便于调试的对象描述，所以返回的字符串会包含类型标识（比如File: 'C:\xxx\a.txt'），而不是单纯的文件路径字符串。

你第一段代码能正常运行，是因为直接调用了File对象的readAsStringSync()方法，没有依赖toString()的结果；而第二段代码错误地将toString()的输出当作文件路径传给File构造函数，导致系统把带File: 前缀的整个字符串识别为路径，自然会抛出「路径语法错误」的异常。

解决方案（保持readFile的高复用性） #

方案1：使用File对象的path属性（最直接） #

File类提供了专门的path属性，它会返回纯文件路径字符串，完全符合你的需求。只需修改main函数中的调用代码：

import 'package:path/path.dart' as p;
import 'dart:io';
import 'dart:async';

void main() async {
  final inDir = p.join(Directory.current.path, 'tmp');
  var dir = Directory(inDir);
  final List<FileSystemEntity> fileList = await dir.list().toList();
  for (var file in fileList.where((entity) => entity is File)) {
    print("Processing ${(file as File).path}"); // 用path输出更简洁的路径
    readFile((file as File).path);
  }
}

void readFile(String filePath) {
  final file = File(filePath); 
  final contents = file.readAsStringSync();
  print(contents);
}

这个方案下，readFile函数依然保持接收字符串路径的特性，能兼容其他传入路径字符串的场景，复用性不受影响。

方案2：让readFile支持多类型输入（更灵活） #

如果希望readFile既能接收File对象，又能接收字符串路径，进一步提升复用性，可以修改函数使其支持动态参数：

import 'package:path/path.dart' as p;
import 'dart:io';
import 'dart:async';

void main() async {
  final inDir = p.join(Directory.current.path, 'tmp');
  var dir = Directory(inDir);
  final List<FileSystemEntity> fileList = await dir.list().toList();
  for (var file in fileList.where((entity) => entity is File)) {
    print("Processing ${(file as File).toString()}");
    readFile(file as File); // 直接传File对象即可
  }
}

void readFile(dynamic fileOrPath) {
  File file;
  if (fileOrPath is File) {
    file = fileOrPath;
  } else if (fileOrPath is String) {
    file = File(fileOrPath);
  } else {
    throw ArgumentError('参数必须是File对象或字符串路径');
  }
  final contents = file.readAsStringSync();
  print(contents);
}

这样readFile既可以处理直接传入的File对象，也能接收任意合法的文件路径字符串，适配更多使用场景，复用性更强。

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