简介Adobe ExtendScript Toolkit CC 是面向 Photoshop 等 Creative Cloud 系列软件脚本开发者的官方脚本编写与调试工具基于 ExtendScript 引擎支持用 JavaScript 自动化与定制工作流程。简体中文汉化版降低了国内用户的理解门槛适合希望批量处理图像、自动化图层操作或搭建跨应用工作流的中高级用户。压缩包共 331 个文件约 9.5MB以 html 帮助文档、jsx 示例脚本、gif 界面图示、dat 语言资源、dll 核心库及少量 css、pdf、exe 等为主其中 ExtendScript.dll 负责脚本解析执行ScCore.dll 与 SciLexer.dll 提供编辑控制和语法高亮ExtendScript Toolkit.exe 则是主程序入口。资源还包含多语言数据文件与示例工程便于对照学习脚本结构与调试方法。目前已有 1734 人学习下载可作为掌握 PS 脚本自动化、断点调试与跨应用交互的实用参考。1. 被时代遗忘的自动化利器Adobe ExtendScript Toolkit CC 到底还能干什么如果你现在还在用 Adobe 的桌面软件做批量处理大概率经历过这种场景几十个 PSD 文件要统一改尺寸、几百个图层要按规则重命名、一批 AI 文件要导出成不同格式。手动操作不仅慢而且容易出错。这时候很多人会想到写脚本而 Adobe ExtendScript Toolkit CC 就是那个曾经官方提供的脚本开发环境。它本质上是一个 IDE专门用来编写、调试和运行 ExtendScript——Adobe 基于 ECMAScript 标准扩展出来的一套脚本语言能直接操作 Photoshop、Illustrator、InDesign 等软件的对象模型。这个工具解决的核心问题是让你用代码代替鼠标把重复劳动变成可复用的自动化流程。它适合两类人一是经常处理大批量设计文件的从业者二是想给团队做内部工具的效率工程师。虽然 Adobe 后来主推 UXP 和插件体系但 ExtendScript 在存量项目里依然跑得动很多老脚本至今还在产线上干活。这一章先把这个工具的定位和适用边界讲清楚后面再一步步拆怎么用。2. 环境搭建与第一个可运行脚本从装好到跑通2.1 安装 ExtendScript Toolkit CC 与目标软件的连接配置ExtendScript Toolkit CC 通常随 Adobe Creative Cloud 套件一起安装也可以在 Adobe 的旧版组件里单独找到。安装完成后打开软件你会看到一个类似简化版代码编辑器的界面。关键一步是配置目标应用程序的连接在工具栏上有一个下拉菜单默认显示「ExtendScript Toolkit」点开后会列出本机已安装的 Adobe 软件比如 Photoshop、Illustrator、InDesign。选中你要操作的目标软件Toolkit 就会尝试建立连接。连接成功的标志是下拉菜单旁边的状态指示灯变绿。如果一直是灰色或红色常见原因是目标软件没有启动或者版本不匹配。我一般会先把 Photoshop 打开再回到 Toolkit 里选它。另外如果用的是较新的 Photoshop 版本可能需要手动开启「允许脚本写入文件」之类的权限在首选项里能找到。配置好连接后你可以在 Toolkit 里直接写代码按 F5 运行结果会输出到下方的控制台。这个控制台是调试的主力所有$.writeln()的输出都会显示在这里。2.2 用一段最小代码验证 Photoshop 对象模型是否可用下面这段代码是我每次换环境后必跑的验证脚本作用是让 Photoshop 新建一个文档、画一个矩形、然后输出文档信息。它能同时验证连接、对象模型和基本绘图 API 是否正常。// 验证 Photoshop ExtendScript 环境是否可用 // 确保 Photoshop 已启动且 Toolkit 已连接到 Photoshop // 检查是否有活动文档没有就新建一个 if (app.documents.length 0) { // 新建文档宽度 800px高度 600px分辨率 72 app.documents.add(800, 600, 72, 验证文档); } var doc app.activeDocument; // 在当前图层画一个矩形选区 doc.selection.select([ [100, 100], [300, 100], [300, 250], [100, 250] ]); // 用前景色填充选区 doc.selection.fill(app.foregroundColor); // 取消选区 doc.selection.deselect(); // 输出文档名称和图层数量到控制台 $.writeln(当前文档 doc.name); $.writeln(图层数量 doc.layers.length); $.writeln(文档宽度 doc.width);这段代码的逻辑很直白先判断有没有打开的文档没有就新建一个然后用selection.select()传入四个坐标点定义矩形选区接着用fill()填充前景色最后取消选区并打印信息。参数方面documents.add()的四个参数分别是宽度、高度、分辨率和文档名单位默认是像素。selection.select()接收一个二维数组每个子数组是一个坐标点按顺序连成路径。运行后如果控制台输出了文档信息说明环境没问题。如果报错「app 未定义」多半是 Toolkit 没有连接到 Photoshop回到第 2.1 步检查连接状态。2.3 脚本文件保存与在目标软件中直接调用在 Toolkit 里写好的代码保存为.jsx文件。这个扩展名是 ExtendScript 的标准格式。保存后你有两种方式在目标软件里调用它一是直接在 Toolkit 里按 F5 运行二是把.jsx文件放到 Photoshop 的Presets/Scripts目录下重启 Photoshop 后在「文件 脚本」菜单里就能看到它。我一般会先在 Toolkit 里调试通过再复制到 Scripts 目录做最终集成。注意如果脚本里用了#target photoshop这样的指令Toolkit 会自动切换到对应的目标软件不需要手动选连接。这个指令写在文件第一行对多软件协作的脚本很有用。// 文件第一行指定目标为 Photoshop #target photoshop // 后续代码可以直接使用 app 对象 var doc app.activeDocument; $.writeln(当前文档 doc.name);加上#target后即使 Toolkit 当前连接的是 Illustrator运行这段代码时也会自动转向 Photoshop。这个机制在写跨软件脚本时能省不少事。3. 核心对象模型与批量处理把重复劳动交给循环3.1 理解 DOM从 app 到 layer 的层级关系ExtendScript 操作 Adobe 软件的核心是 DOM文档对象模型。以 Photoshop 为例顶层是app代表整个应用程序app.documents是所有打开文档的集合每个文档下有layers图层集合图层下还有artLayers、textItem等具体属性。这套层级关系是写脚本的基础搞清楚之后你就能像操作文件夹一样操作设计文件。我习惯在写复杂脚本前先用一小段代码把当前文档的结构打印出来确认对象路径对不对。比如下面这段会列出当前文档所有图层的名称和类型。// 遍历当前文档的所有图层输出名称和类型 var doc app.activeDocument; var layers doc.layers; for (var i 0; i layers.length; i) { var layer layers[i]; $.writeln(图层 i layer.name | 类型 layer.typename); }layer.typename返回的是图层类型比如ArtLayer表示普通图层LayerSet表示图层组。知道类型后你才能决定下一步能调用哪些方法。比如ArtLayer有kind属性可以区分像素图层和文本图层而LayerSet可以继续往下遍历子图层。3.2 批量重命名图层的完整脚本与参数说明批量重命名是 ExtendScript 最典型的应用场景。下面这个脚本会把当前文档里所有图层按「前缀_序号」的规则重命名并且跳过背景层。// 批量重命名图层前缀_序号 // 跳过背景层序号从 1 开始 var doc app.activeDocument; var layers doc.layers; var prefix Layer; // 可修改前缀 var counter 1; for (var i 0; i layers.length; i) { var layer layers[i]; // 跳过背景层 if (layer.isBackgroundLayer) { continue; } // 按规则重命名 layer.name prefix _ counter; counter; } $.writeln(重命名完成共处理 (counter - 1) 个图层。);这段代码的关键点有三个一是isBackgroundLayer属性用来识别背景层避免误改二是layer.name可以直接赋值实现重命名三是counter变量控制序号递增。参数方面prefix可以改成你需要的任何前缀比如项目编号或日期。如果图层数量很多建议在循环里加一个app.refresh()让界面及时刷新避免看起来像卡死。3.3 批量导出不同格式PNG、JPG 与 PDF 的导出参数批量导出是另一个高频需求。下面这个脚本会把当前文档导出为 PNG 和 JPG 两种格式保存到桌面上的一个文件夹里。导出前会自动创建文件夹。// 批量导出当前文档为 PNG 和 JPG // 保存到桌面上的 Export_Output 文件夹 var doc app.activeDocument; var desktop Folder.desktop; var outputFolder new Folder(desktop /Export_Output); // 如果文件夹不存在就创建 if (!outputFolder.exists) { outputFolder.create(); } // 导出 PNG var pngOptions new PNGSaveOptions(); pngOptions.compression 6; // 压缩级别 0-96 是平衡值 pngOptions.interlaced false; var pngFile new File(outputFolder / doc.name .png); doc.saveAs(pngFile, pngOptions, true, Extension.LOWERCASE); // 导出 JPG var jpgOptions new JPEGSaveOptions(); jpgOptions.quality 10; // 质量 0-1210 是高质量 jpgOptions.embedColorProfile true; var jpgFile new File(outputFolder / doc.name .jpg); doc.saveAs(jpgFile, jpgOptions, true, Extension.LOWERCASE); $.writeln(导出完成文件保存在 outputFolder);参数说明PNGSaveOptions的compression控制压缩级别数值越大文件越小但耗时越长6 是常用平衡点。JPEGSaveOptions的quality范围是 0 到 1210 以上画质很好但文件偏大。saveAs的第三个参数true表示保存为副本不覆盖原文件第四个参数Extension.LOWERCASE确保扩展名小写。如果导出 PDF需要用PDFSaveOptions可以设置preset为PDFPresetType.HIGHQUALITYPRINT等预设值。导出前记得检查文档是否有多余的 Alpha 通道否则 PNG 可能会带透明背景和预期不符。4. 避坑与排查那些让我熬夜的报错和玄学问题4.1 连接不上目标软件指示灯不绿怎么办现象Toolkit 下拉菜单里选了 Photoshop但状态灯一直不绿运行脚本报「app 未定义」。原因最常见的是 Photoshop 没有完全启动或者 Toolkit 和 Photoshop 的版本位数不一致比如 64 位 Toolkit 连 32 位 Photoshop。另外某些系统权限设置会阻止 Toolkit 访问目标软件。解决先确认 Photoshop 已经打开并且没有卡在启动界面。然后检查两者版本尽量用同一套 CC 版本安装的组件。如果还是不行重启 Toolkit 和 Photoshop顺序是先开 Photoshop再开 Toolkit。我遇到过几次是系统更新后权限被重置手动在安全设置里允许 Toolkit 控制其他应用后恢复正常。4.2 脚本在 Toolkit 里能跑放到 Scripts 目录就失效现象在 Toolkit 里按 F5 一切正常把.jsx文件复制到Presets/Scripts后重启 Photoshop菜单里能看到脚本但点击后没反应或报错。原因Toolkit 运行时默认带了调试环境而 Photoshop 直接调用脚本时某些全局对象或路径解析方式不同。最常见的是脚本里用了相对路径或者依赖了 Toolkit 特有的$.writeln输出。解决把脚本里所有路径改成绝对路径用Folder.desktop或Folder.myDocuments这类标准对象来定位。$.writeln在 Photoshop 里不会报错但也不会有输出可以改成写入一个日志文件。另外确保脚本第一行有#target photoshop避免目标不明确。4.3 循环处理大量文件时内存暴涨或崩溃现象写了一个遍历几百个 PSD 文件的脚本跑了几十个之后 Photoshop 越来越慢最后直接崩溃。原因每次打开文档都会占用内存如果脚本里没有及时关闭文档内存就会持续累积。另外某些操作比如历史记录也会让内存增长。解决在循环里每处理完一个文档就调用doc.close(SaveOptions.DONOTSAVECHANGES)关闭它并且定期调用app.purge(PurgeTarget.ALLCACHES)清理缓存。如果文件特别多可以分批处理每批之间加一个短暂的延时。我一般会在循环里加一个计数器每处理 20 个文件就清理一次。4.4 中文路径或文件名导致保存失败现象脚本里用中文命名输出文件或文件夹在部分系统上保存时报错「文件不存在」或「路径无效」。原因ExtendScript 的File和Folder对象对非 ASCII 字符的处理在不同系统上有差异尤其是 Windows 和 macOS 之间。解决尽量用英文命名输出文件和文件夹。如果必须用中文确保脚本文件本身保存为 UTF-8 编码并且在创建File对象时用encodeURI处理路径。更稳妥的做法是让用户通过对话框选择输出目录而不是在代码里硬编码中文路径。4.5 脚本执行速度慢哪些操作最耗时现象一个简单的批量重命名脚本跑几百个图层要等好几秒感觉不流畅。原因ExtendScript 是单线程的每次修改图层属性都会触发界面刷新。如果循环里频繁操作界面速度就会慢。解决在批量操作前先设置app.displayDialogs DialogModes.NO关闭不必要的对话框。对于大量图层的操作可以先把文档的activeLayer设为一个不相关的图层减少界面重绘。另外尽量批量读取属性再批量写入避免在循环里反复查询同一个值。5. 进阶技巧用脚本做条件判断与跨软件协作5.1 根据图层名称自动分类并创建图层组当文档里图层很多时按名称关键词自动分组能省大量时间。下面这个脚本会遍历所有顶层图层如果名称包含「btn」就放进「按钮」组包含「bg」就放进「背景」组。// 按图层名称关键词自动分组 var doc app.activeDocument; var layers doc.layers; // 创建两个图层组 var btnGroup doc.layerSets.add(); btnGroup.name 按钮; var bgGroup doc.layerSets.add(); bgGroup.name 背景; // 从后往前遍历避免移动图层时索引变化 for (var i layers.length - 1; i 0; i--) { var layer layers[i]; var name layer.name.toLowerCase(); if (name.indexOf(btn) ! -1) { layer.move(btnGroup, ElementPlacement.INSIDE); } else if (name.indexOf(bg) ! -1) { layer.move(bgGroup, ElementPlacement.INSIDE); } }关键点是倒序遍历因为move操作会改变图层集合的索引正序遍历容易漏掉或重复处理。ElementPlacement.INSIDE表示把图层移动到组内部。这个模式可以扩展到更多分类规则只需要增加else if分支。5.2 在 Illustrator 和 Photoshop 之间传递数据ExtendScript 支持跨软件操作但需要分别连接。一个常见需求是从 Illustrator 读取路径数据然后在 Photoshop 里生成对应形状。下面是一个简化示例展示如何切换目标软件。// 跨软件示例先连接 Illustrator 读取文档信息 #target illustrator var aiDoc app.activeDocument; var aiName aiDoc.name; $.writeln(Illustrator 文档 aiName); // 再连接 Photoshop 新建文档 #target photoshop app.documents.add(800, 600, 72, 来自AI的文档); $.writeln(Photoshop 文档已创建。);注意#target指令在同一个脚本里可以多次使用但每次切换后需要重新获取app对象。实际项目中跨软件协作更适合拆成两个脚本通过中间文件比如 JSON 或 CSV传递数据这样更稳定也更好调试。5.3 用脚本做条件判断根据文档尺寸决定导出参数不同尺寸的文档可能需要不同的导出设置。下面这个脚本根据文档宽度决定 JPG 质量宽度大于 2000px 用质量 8否则用质量 10。// 根据文档宽度动态设置 JPG 质量 var doc app.activeDocument; var width doc.width.value; // 获取宽度数值 var quality width 2000 ? 8 : 10; var jpgOptions new JPEGSaveOptions(); jpgOptions.quality quality; var outputFile new File(Folder.desktop / doc.name .jpg); doc.saveAs(outputFile, jpgOptions, true, Extension.LOWERCASE); $.writeln(文档宽度 width 使用质量 quality);doc.width.value返回的是数值不带单位。这个模式可以扩展到根据高度、分辨率、图层数量等条件动态调整参数。我一般会把判断逻辑写成独立的函数方便复用和测试。5.4 调试技巧用 try-catch 捕获错误并写入日志ExtendScript 的报错信息有时很模糊用try-catch包裹关键代码把错误写入日志文件能大幅缩短排查时间。// 带错误捕获的批量处理模板 var logFile new File(Folder.desktop /script_log.txt); logFile.open(w); try { var doc app.activeDocument; var layers doc.layers; for (var i 0; i layers.length; i) { layers[i].name Processed_ i; } logFile.writeln(成功处理 layers.length 个图层。); } catch (e) { logFile.writeln(错误 e.message); logFile.writeln(行号 e.line); } finally { logFile.close(); }e.message给出错误描述e.line给出出错行号。finally块确保日志文件一定会关闭。这个模板我用了很多年尤其是在处理不确定来源的文件时能避免脚本静默失败。5.5 把常用功能封装成函数库当脚本越来越多时把重复逻辑抽成函数库能省很多事。比如下面这个resizeDocument函数可以按最大边限制等比缩放文档。// 等比缩放文档使最大边不超过 maxSize function resizeDocument(doc, maxSize) { var w doc.width.value; var h doc.height.value; var maxSide Math.max(w, h); if (maxSide maxSize) { return; // 不需要缩放 } var ratio maxSize / maxSide; doc.resizeImage(w * ratio, h * ratio, doc.resolution, ResampleMethod.BICUBIC); } // 调用示例 var doc app.activeDocument; resizeDocument(doc, 1920); $.writeln(缩放完成新宽度 doc.width.value);resizeImage的第四个参数是重采样方法BICUBIC适合照片类图像BICUBICSHARPER适合需要锐度的场景。把这个函数保存为单独的.jsx文件用#include引入到其他脚本里就能像搭积木一样组合功能。我自己的习惯是每做完一个项目就把这次用到的通用逻辑抽出来放进函数库下次直接调用。几年下来这个库成了我处理 Adobe 批量任务时最值钱的东西。希望帮到你。本文还有配套的精品资源点击获取