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 標識一個現有目錄，則操作失敗，並且未來會以異常結束。