掌握 Photoshop 脚本 Folder 对象:批量处理文件的利器

在 Photoshop 的 JavaScript 脚本(ExtendScript)中,Folder 对象是一个核心工具,用于处理文件系统中的文件夹操作。它提供了对文件夹的创建、检查、遍历、文件筛选等功能,是自动化批量处理任务的重要基础。以下是 Folder 对象的详细介绍:


1. 创建 Folder 对象

语法

javascript 复制代码
var folder = new Folder("文件夹路径");
  • 路径 :可以是绝对路径(如 "C:/Users/YourName/Desktop")或相对路径(如 "~/Desktop")。

  • 示例

    javascript 复制代码
    var myFolder = new Folder("C:/Projects/MyImages");

2. 常用方法

(1)创建文件夹
  • 方法folder.create()

  • 描述 :在指定路径创建文件夹,若文件夹已存在则返回 false

  • 示例

    javascript 复制代码
    var folderPath = "C:/Projects/NewFolder";
    var folder = new Folder(folderPath);
    if (!folder.exists) {
        folder.create();
        $.writeln("文件夹创建成功:" + folderPath);
    } else {
        $.writeln("文件夹已存在:" + folderPath);
    }
(2)检查文件夹是否存在
  • 属性folder.exists

  • 描述 :返回布尔值,true 表示文件夹存在,false 表示不存在。

  • 示例

    javascript 复制代码
    var folder = new Folder("C:/Projects/MyImages");
    if (folder.exists) {
        $.writeln("文件夹存在");
    } else {
        $.writeln("文件夹不存在");
    }
(3)获取文件夹中的文件
  • 方法folder.getFiles()
  • 描述:返回文件夹中所有文件和子文件夹的数组。
  • 过滤文件
    • 结合 Array.filter() 筛选特定类型的文件。

    • 示例 :获取所有 .jpg 文件:

      javascript 复制代码
      var folder = new Folder("C:/Projects/MyImages");
      var files = folder.getFiles().filter(function(file) {
          return file instanceof File && /\.(jpg|jpeg)$/i.test(file.name);
      });
      files.forEach(function(file) {
          $.writeln("找到文件:" + file.name);
      });
(4)递归遍历子文件夹
  • 示例 :遍历文件夹及其子文件夹中的所有文件:

    javascript 复制代码
    function traverseFolder(folder) {
        var files = folder.getFiles();
        for (var i = 0; i < files.length; i++) {
            if (files[i] instanceof Folder) {
                traverseFolder(files[i]); // 递归子文件夹
            } else if (files[i] instanceof File) {
                $.writeln("文件:" + files[i].fsName);
            }
        }
    }
    var rootFolder = new Folder("C:/Projects");
    traverseFolder(rootFolder);
(5)删除文件夹
  • 方法folder.remove()

  • 描述:删除文件夹及其所有内容,需谨慎使用。

  • 示例

    javascript 复制代码
    var folder = new Folder("C:/Projects/TempFolder");
    if (folder.exists) {
        folder.remove();
        $.writeln("文件夹已删除");
    }

3. 常用属性

属性 描述
exists 返回布尔值,表示文件夹是否存在。
fsName 返回文件夹的完整路径(字符串)。
name 返回文件夹的名称(不包含路径)。
parent 返回父文件夹的 Folder 对象。

4. 典型应用场景

  1. 批量处理文件

    • 遍历文件夹中的所有图像文件,进行统一调整(如调整大小、格式转换)。

    • 示例 :批量调整图像大小:

      javascript 复制代码
      var folder = Folder.selectDialog("选择图片文件夹");
      if (folder) {
          var files = folder.getFiles(/\.(jpg|png)$/i);
          for (var i = 0; i < files.length; i++) {
              var doc = app.open(files[i]);
              doc.resizeImage(800, 600);
              doc.saveAs(new File(files[i].parent + "/" + files[i].name.replace(/\.\w+$/, "_resized.jpg")));
              doc.close(SaveOptions.DONOTSAVECHANGES);
          }
      }
  2. 自动化项目结构

    • 创建项目所需的文件夹结构(如 源文件输出备份)。

    • 示例

      javascript 复制代码
      var baseFolder = new Folder("C:/Projects/MyProject");
      if (!baseFolder.exists) {
          baseFolder.create();
          ["源文件", "输出", "备份"].forEach(function(name) {
              new Folder(baseFolder.fsName + "/" + name).create();
          });
          $.writeln("项目结构创建完成");
      }
  3. 文件备份与归档

    • 将特定文件复制到备份文件夹。

5. 注意事项

  1. 路径格式

    • Windows 路径使用反斜杠(\\)或正斜杠(/)。
    • macOS 路径使用正斜杠(/)。
  2. 权限问题

    • 确保脚本有权限访问目标文件夹,否则会抛出错误。
  3. 错误处理

    • 使用 try-catch 捕获异常,避免脚本中断。

    • 示例

      javascript 复制代码
      try {
          var folder = new Folder("C:/InvalidPath");
          folder.create();
      } catch (e) {
          $.writeln("错误:" + e.message);
      }

6. 扩展功能

  • 结合 File 对象
    • FolderFile 对象通常配合使用,实现完整的文件系统操作。
  • 结合 Photoshop API
    • 在脚本中调用 Photoshop 功能(如打开文件、保存文件),实现自动化图像处理。

总结

Folder 对象是 Photoshop JavaScript 脚本中处理文件夹的核心工具,提供了丰富的属性和方法,支持文件夹的创建、检查、遍历、文件筛选等操作。通过结合 File 对象和 Photoshop API,开发者可以实现高度自动化的批量处理任务,大幅提升工作效率。

相关推荐
尤老师FPGA12 小时前
使用ZYNQ芯片和LVGL框架实现用户高刷新UI设计系列教程(第十一讲)
ui
264玫瑰资源库2 天前
网狐旗舰大联盟组件源码私测笔记:结构分层、UI重构与本地实操全流程
java·前端·数据库·笔记·ui·重构
高木的小天才3 天前
HarmonyOS ArkUI安全控件开发指南:粘贴、保存与位置控件的实现与隐私保护实践
安全·ui·华为·typescript·harmonyos
军训猫猫头3 天前
91.首次使用Maui的体验与建议 C#例子 Maui例子
ui·智能手机·c#
高木的小天才3 天前
HarmonyOS ArkUI交互事件与手势处理全解析:从基础到高级实践
ui·华为·typescript·交互·harmonyos
陈奕昆4 天前
【LLaMA-Factory实战】Web UI快速上手:可视化大模型微调全流程
前端·ui·llama·大模型微调实战
OJAC近屿智能4 天前
宇树科技开启“人形机器人格斗盛宴”
人工智能·科技·ui·机器人·aigc·llama·近屿智能
fei_sun5 天前
【HarmonyOS】作业三 UI
ui·华为·harmonyos
向宇it5 天前
【unity游戏开发入门到精通——UGUI】UGUI自动布局组件
游戏·ui·unity·c#·游戏引擎
军训猫猫头5 天前
92.一个简单的输入与显示示例 Maui例子 C#例子
ui·智能手机·c#