简介：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-9，6 是平衡值 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-12，10 是高质量 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 到 12，10 以上画质很好但文件偏大。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 批量任务时最值钱的东西。希望帮到你。
本文还有配套的精品资源，点击获取
