Dart File.rename用法及代码示例

重命名此文件。

返回一个 Future<File>，以 File 完成重命名文件。

如果 newPath 是相对路径，则根据当前工作目录 (Directory.current) 进行解析。这意味着只需更改文件的名称，但将其保留为原始目录，就需要创建一个新的完整路径，并在末尾使用新名称。例子：

Future<File> changeFileNameOnly(File file, String newFileName) {
  var path = file.path;
  var lastSeparator = path.lastIndexOf(Platform.pathSeparator);
  var newPath = path.substring(0, lastSeparator + 1) + newFileName;
  return file.rename(newPath);
}

在某些平台上，重命名操作无法在不同文件系统之间移动文件。如果是这种情况，请改为将copy 文件移至新位置，然后删除原始文件。

如果newPath 标识现有文件，则首先删除该文件。如果newPath 标识一个现有目录，则操作失败，并且未来会以异常结束。