使用URLResourceValues重命名iOS文件失效问题排查

• 核心误区：URL对象不会自动同步文件系统变更
  你定义的mutableFileURL是原fileURL的副本，本质是一个路径字符串的容器。调用setResourceValues修改的是文件系统中实际文件的名称，但不会自动更新当前变量里的URL路径。如果要验证文件是否已重命名，需要重新读取该URL的属性：

  try! mutableFileURL.setResourceValues(resourceValues)
  // 读取更新后的文件名
  let updatedName = try! mutableFileURL.resourceValues(forKeys: [.nameKey]).name
  print(updatedName) // 此处会输出新文件名
  

• 为什么变量显示旧文件名？
  你看到mutableFileURL仍保留旧名称，是因为该变量存储的还是最初的路径字符串，并没有自动刷新。但文件系统中的文件其实已经完成重命名——你可以直接查看Documents目录下的实际文件，或者重新调用contentsOfDirectory获取目录内容，就能看到更新后的文件名。

• 额外注意事项

  1. 确保newFilename仅包含文件名（不能带路径），否则设置name属性会无效且不抛出错误。
  2. 若目录中已有同名文件，setResourceValues会抛出错误，但你使用try!会直接崩溃，所以你的场景不存在重名冲突。
  3. iOS 14+ 完全支持通过URLResourceValues.name重命名文件，你的运行系统（iOS 16.1）不存在兼容性问题。

• 与moveItem的差异
  FileManager.moveItem(at:to:)需要你提前构建新的完整URL路径，调用后手里的newFileURL本身就是新路径，所以直观上能看到路径变化，但本质和setResourceValues修改name的效果一致——都是修改文件系统中的文件名称。

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