简介《教你如何自学AE脚本》面向影视后期爱好者与AE初学者针对不会写脚本、不知从何入手的困惑梳理从界面操作到脚本开发的进阶路线。资源包内仅1个doc文档约4.59MB适合电脑端查阅。内容按主观与客观要求展开先熟悉AE图层、属性、关键帧等界面元素再掌握基于JavaScript的AE表达式随后补足变量、数据类型、函数、循环、条件判断等JavaScript基础并了解对象、属性、数组、字符串的常用操作甚至借助eval()读取文本并执行代码模拟include式预编译。文中还推荐After Effects Reference、Scripting Guide、JavaScript Tools Guide、ScriptUI等官方文档与中文手册配合使用。已有95人学习。其价值在于给出清晰的学习顺序、文档检索思路与社区求助建议并强调用小脚本实践巩固技能帮助自学者少走弯路逐步写出接近专业插件水准的AE脚本。1. 别急着装插件AE自带的脚本接口才是效率入口多数人的AE自学路径是先搜 ae下载 装好软件再囤模板和 ae插件最后卡在“每次都要手动改二十个图层”这种重复劳动上。被忽略的是AE自带一整套脚本接口 ExtendScript它是一门基于JavaScript的老语言能直接读写工程、合成、图层、属性、关键帧和渲染队列。收益很具体批量重命名、按数据生成动画、统一改参数、自动出片原本一小时的活能压到几秒。代价是它缺少系统的中文资料报错信息很粗糙社区示例散落各处。下面按“环境搭起来、对象模型摸清楚、脚本抄起来、排错进阶”的顺序把自学AE脚本这件事拆成能照着做的一条路。2. 自学AE脚本的第一道坎运行环境、调试入口和路线图2.1 ExtendScript是门什么语言自学它要先放弃什么AE脚本的语言叫 ExtendScript本质是 ES3 级别的 JavaScript文件后缀是.jsx。这意味着你在前端里习惯的很多东西在这里不存在没有let、const、箭头函数、模板字符串、Promise变量统一用var字符串拼接用。初学阶段最容易踩的坑就是照着现代JS教程写然后AE直接报语法错误。好消息是写AE脚本真正需要的语法很少。for循环、if判断、函数、对象和数组这五样覆盖了九成以上的实用脚本。算法和设计模式在这里派不上用场真正的门槛在“知道AE有哪些对象、每个对象有哪些属性能改”也就是后面第3章要讲的API模型。所以自学顺序应该是先花半天过一遍ES3语法差异然后把时间全部投在API上。调试输出统一用$.writeln()它会写到 ExtendScript Toolkit 的控制台如果用 VS Code 加 ExtendScript 调试扩展就能直接断点和看变量。相比之下alert()只适合确认脚本有没有跑到某一行别拿它做正式调试手段。2.2 脚本往哪放Run Script File、ScriptUI Panels、Startup 三种加载方式自学阶段最常见的困惑是“脚本写好了AE里找不到”。AE识别脚本靠目录不靠导入功能。三种加载方式的区别必须先记住。加载方式存放位置生效时机适合场景Run Script File任意目录手动点 File Scripts Run Script File边写边跑的临时调试ScriptUI PanelsScripts/ScriptUI Panels/子目录重启AE后出现在 Window 菜单自定义脚本面板可停靠StartupScripts/Startup/子目录AE启动时自动执行注册菜单项、初始化环境Windows 下脚本目录一般在C:\Program Files\Adobe\Adobe After Effects 版本\Support Files\Scripts\macOS 下在/Applications/Adobe After Effects 版本/Scripts/。这两个路径都需要管理员权限才能写入改文件时记得用管理员身份打开编辑器否则保存会静默失败。提示新版本AE默认禁止脚本写文件和访问网络用到File、Folder相关操作前先在首选项的脚本与表达式面板里打开“允许脚本写入文件和访问网络”否则报错会指向莫名其妙的位置。2.3 十行代码跑通第一个AE脚本建合成、加文字层先跑通再理解。下面这段脚本做三件事建一个1920×1080、5秒、25帧的合成加一个文字层改写文字内容。// hello_ae.jsx —— 最小可运行示例 app.beginUndoGroup(新建合成与文字层); // 把后续操作打包成一次撤销 var comp app.project.items.addComp( Demo, // 合成名 1920, 1080, // 宽、高像素 1, // 像素长宽比方形像素填1 5, // 时长秒 25 // 帧率 ); var textLayer comp.layers.addText(Hello AE Script); // 加文字层并给初值 var srcText textLayer.property(Source Text); // 取到源文本属性 srcText.setValue(第一行脚本跑通了); // 写入新的文本 comp.openInViewer(); // 在合成面板打开看结果 app.endUndoGroup(); // 结束撤销组addComp的五个参数顺序容易记错按“名字、宽、高、像素比、时长、帧率”背下来时长单位是秒不是帧和界面上的时间码显示不一样脚本里想按帧算得自己除以帧率。addText返回的是 TextLayer 对象它和普通图层共用property()接口。beginUndoGroup和endUndoGroup成对出现中间的操作用 CtrlZ 一次就能全部撤销少写一次endUndoGroupAE的撤销栈会一直卡住只能重启软件。2.4 自学路线拆成四个阶段两个月能到能用的程度脚本学习的进度差异极大有人卡在环境上两周有人三天就能改现成脚本。按目标拆阶段比按知识点拆更有效。阶段目标产出大致投入一、跑通环境、加载方式、撤销组能改文字的脚本35 天二、读得懂对象模型与 matchName能看懂别人的脚本12 周三、写得出循环、条件、属性读写批量处理类脚本23 周四、用得顺UI面板、渲染队列、排错日常工具集持续积累阶段二有个关键动作拿到任何一个脚本先不看逻辑先把里面出现的app.、comp.、layer.开头的调用全部抄下来查一遍。抄满两页纸你对API的直觉就建立起来了。阶段三开始给自己找真实需求比如“把选中图层的模糊度按顺序递增”这种小需求写十个比看十篇教程有用。3. AE脚本核心对象模型app、project、item、layer、property3.1 app与project脚本世界的两个根节点所有脚本都从app开始。app.project是当前打开的工程app.project.activeItem是当前激活的面板对象可能是合成、素材也可能是null。新手脚本里最常见的崩溃就是直接对activeItem开刀结果用户选中的是一个素材文件。正确姿势是每次都用instanceof判断类型// guard.jsx —— 所有操作前的类型守卫 var comp app.project.activeItem; if (!(comp instanceof CompItem)) { alert(请先选中一个合成); } else { // 这里再开始动 comp $.writeln(合成时长 comp.duration 秒共 comp.numLayers 个图层); }instanceof CompItem是判断“这是不是合成”的标准写法同理还有FootageItem、FolderItem、TextLayer、ShapeLayer、AVLayer。注意图层类型的继承关系文字层和形状层都是AVLayer的子类所以判断顺序要从具体到宽泛先判TextLayer再判AVLayer反过来永远进不去第一个分支。app.project上还有几个高频成员numItems是工程面板里的项目总数items是集合下标从1开始。这一点和JavaScript数组完全不同for (var i 0; i numItems; i)这种写法会漏掉第一个、越界最后一个必须写成i 1; i numItems。3.2 item家族CompItem、FootageItem、FolderItem的遍历与区分工程面板里的每一项都是 item三种类型各有用途。要批量处理先得会遍历// scan_items.jsx —— 遍历工程并分类统计 var comps [], footages [], folders []; for (var i 1; i app.project.numItems; i) { var it app.project.item(i); if (it instanceof CompItem) { comps.push(it.name); } else if (it instanceof FootageItem) { footages.push(it.name [ it.width x it.height ]); } else if (it instanceof FolderItem) { folders.push(it.name); } } $.writeln(合成 comps.length 个 comps.join(、)); $.writeln(素材 footages.length 个 footages.join(、));遍历里做大扫除类脚本很实用比如找出所有尺寸不是1920×1080的素材。但要注意素材的width和height属性对音频文件无效读之前先用it.hasVideo判断一下否则会拿到undefined再做运算结果全是 NaN。另外工程面板里的项目顺序不完全等于界面显示的排序用户在界面里点过“按名称排序”之后脚本读到的还是原始顺序别依赖它做编号。3.3 layer与property图层操作的统一入口图层上的一切可改参数都是属性对象统一用property()取。关键点是参数用matchName而不是界面上的中文名——中文名会随软件语言变化matchName在任何语言版本下都一样。界面名称matchName维度不透明度ADBE Opacity1位置ADBE Position2 或 3缩放ADBE Scale2 或 3旋转ADBE Rotate Z1源文本ADBE Text Properties下的ADBE Text Document文本对象有些属性是分组的比如源文本要先取组再取属性。写脚本时不必背全表用下面这段遍历打印出来就能查// dump_props.jsx —— 打印图层的属性树用来查 matchName var comp app.project.activeItem; for (var i 1; i comp.numLayers; i) { var ly comp.layer(i); $.writeln(图层 i ly.name / 类型 ly.matchName); for (var j 1; j ly.numProperties; j) { var p ly.property(j); $.writeln( p.name - p.matchName); } }输出里的第二列就是matchName直接复制进脚本即可。图层索引和图层ID不是一回事comp.layer(i)按堆叠顺序取用户拖动图层后编号会变layer.index同样会变只有layer.id在整个工程生命周期里不变。脚本要引用固定图层时存ID别存索引。3.4 关键帧读写与缓动setValueAtTime和KeyframeEase打关键帧的核心就三个方法setValueAtTime(时间, 值)、keyTime(i)、keyValue(i)。时间单位是秒。// keyframe_demo.jsx —— 读关键帧并设置缓入缓出 var op app.project.activeItem.layer(1).property(ADBE Opacity); op.setValueAtTime(0, 0); // 第0秒不透明度0 op.setValueAtTime(1, 100); // 第1秒不透明度100 for (var i 1; i op.numKeys; i) { $.writeln(关键帧 i op.keyTime(i) 秒 - op.keyValue(i)); } // 给第1个关键帧加缓入缓出1维属性传长度为1的数组 op.setTemporalEaseAtKey(1, [new KeyframeEase(0, 33)], [new KeyframeEase(0, 33)]);KeyframeEase的两个参数是速度和影响量影响量范围010033是界面里“缓动”预设的典型值。数组长度必须和属性维度一致不透明度是1维传1个位置是2维传2个传错会直接抛错。不透明度还有个上限问题值超过100会报错做缩放类的动效要靠其它属性。3.5 表达式和脚本怎么分工别用错工具两者都能改参数场景完全不同。对比项表达式脚本生效时机每帧实时计算运行一次写入结果依赖数据可引用其它图层、时间可读写文件、遍历工程适合联动、跟随、循环批量、初始化、导出不适合修改图层结构需要随参数实时变化的动效判断原则很简单结果需要随用户改参数自动重算用表达式只需要一次性把工程结构改对用脚本。把批量改一百个图层的关键帧写成表达式是自学阶段最常见的误用那样每个图层都要手动复制粘贴表达式等于没省事。4. 能直接抄的五个AE脚本实战4.1 批量重命名选中图层最简单的循环练手// rename_layers.jsx —— 按前缀加序号重命名选中图层 var comp app.project.activeItem; if (!(comp instanceof CompItem)) { alert(请先选中一个合成); } else { app.beginUndoGroup(批量重命名图层); var sel comp.selectedLayers; // 只处理当前选中的图层 var prefix BG_; // 前缀按项目约定改 for (var i 0; i sel.length; i) { var idx (0 (i 1)).slice(-2); // 补零到两位 sel[i].name idx _ prefix; } app.endUndoGroup(); $.writeln(已重命名 sel.length 个图层); }selectedLayers返回的是标准JavaScript数组下标从0开始和comp.layer(i)的1起始完全相反这是最容易混淆的地方。序号补零用slice(-2)是个老技巧ES3里没有padStart只能这么写。重命名后图层顺序不变但如果有脚本依赖图层名做匹配改名会让它失效所以别把名字当成唯一标识。4.2 给所有文字层批量加淡入淡出// fade_text.jsx —— 所有文字层加0.5秒淡入淡出 var comp app.project.activeItem; app.beginUndoGroup(文字层淡入淡出); var fade 0.5; // 淡入淡出时长秒 var dur comp.duration; for (var i 1; i comp.numLayers; i) { var ly comp.layer(i); if (ly instanceof TextLayer) { // 只挑文字层 var op ly.property(ADBE Opacity); op.setValueAtTime(0, 0); op.setValueAtTime(fade, 100); op.setValueAtTime(dur - fade, 100); op.setValueAtTime(dur, 0); } } app.endUndoGroup();四个关键帧的位置依赖合成时长所以dur - fade一定要算写死数字换个合成就不对了。如果合成时长小于1秒dur - fade会变成负数AE会报时间越界所以再加一句if (dur fade * 2)做保护更牢靠。文字层上如果已经有关键帧setValueAtTime会覆盖同时间点的值不会重复叠加。4.3 按CSV数据生成数据变化动画这是“ae数据变化”类需求最直接的实现方式——把外部数据读进来逐秒生成关键帧。// csv_driven.jsx —— 读取CSV逐秒写入源文本关键帧 var csv File.openDialog(选择 data.csv); // 取消选择时返回null if (!csv) { alert(没有选择文件); } else { csv.open(r); var lines []; while (!csv.eof) { lines.push(csv.readln()); } csv.close(); app.beginUndoGroup(数据驱动文字动画); var comp app.project.activeItem; var textLayer comp.layers.addText(0); var src textLayer.property(ADBE Text Properties) .property(ADBE Text Document); var t 0; for (var i 0; i lines.length; i) { var val lines[i].replace(/[\r\n]/g, ); if (val ) { continue; } // 跳过空行 var doc src.value; // 取出当前文字文档对象 doc.text val; // 改文本内容 src.setValueAtTime(t, doc); // 在该时刻写入整份文档 t 1; // 每行间隔1秒 } app.endUndoGroup(); $.writeln(共写入 t 个数据点); }源文本不是简单数值它对应一个 TextDocument 对象必须整份取出、改字段、再整份写回不能只改text字段。readln()保留换行符所以要用正则清掉否则每行数据里带一个多余的空字符做数值比较时全不相等。数据量大时建议把时间间隔做成变量或者按CSV里的时间列取别固定成1秒。4.4 渲染队列自动化一次把多个合成排进队列// render_all.jsx —— 把工程内所有合成加入渲染队列 var outDir Folder.selectDialog(选择输出文件夹); if (!outDir) { alert(未选择输出目录); } else { var rq app.project.renderQueue; for (var i 1; i app.project.numItems; i) { var it app.project.item(i); if (it instanceof CompItem) { var item rq.items.add(it); var om item.outputModule(1); // 第1个输出模块 om.file new File(outDir.fsName / it.name _[####].png); } } rq.render(); // 队列为空时调用会报错 }文件名里的[####]是序列文件的占位符输出 PNG 或 JPEG 序列时必须带输出视频文件则不能带写错会报路径无效。outputModule(1)里的1是输出模块序号参数含义由渲染队列模板决定脚本只改文件名、不碰编码参数是最省心的做法。rq.render()是同步阻塞的队列很长时AE界面会假死这种场景更适合改用命令行渲染。4.5 ScriptUI自定义脚本面板最小骨架把常用功能做成可停靠面板是自学到后期最值得做的一件事。// quick_duration.jsx —— 放进 ScriptUI Panels 目录后的可停靠面板 (function (thisObj) { var win (thisObj instanceof Panel) ? thisObj : new Window(palette, 快速改时长, undefined, { resizeable: true }); win.orientation column; win.alignChildren fill; var input win.add(edittext, undefined, 3); var btn win.add(button, undefined, 应用到选中合成); btn.onClick function () { var comp app.project.activeItem; if (comp instanceof CompItem) { app.beginUndoGroup(修改合成时长); comp.duration parseFloat(input.text); // 单位秒 app.endUndoGroup(); } else { alert(请先选中一个合成); } }; win.layout.layout(true); if (win instanceof Window) { win.show(); } // 独立窗口才需要show })(this);关键在最后的(this)传参。通过 Window 菜单打开时AE传给脚本的this就是一个 Panel 实例此时必须复用它不能新建 Window否则面板停靠会异常。直接用 Run Script File 运行时this不是 Panel才走新建窗口的分支。这个双分支写法是所有 ScriptUI 面板脚本的通用模板。脚本触发方式核心API批量重命名手动运行selectedLayers、layer.name文字淡入淡出手动运行setValueAtTimeCSV数据动画手动运行 文件对话框File.openDialog、TextDocument批量渲染手动运行renderQueue.items.add自定义面板Window 菜单Panel、Window.add5. AE脚本排错与进阶报错定位、芯片兼容和性能边界5.1 三类高频报错按这个顺序查AE的报错信息很少给出具体行号靠模式识别更快。报错内容常见原因处理办法undefined is not an objectactiveItem为 null 或类型不对加instanceof守卫Object does not support the property or method方法名拼错或对象类型不匹配打印对象类型再比对文档property is not a function把属性对象当函数调用去掉多余的括号时间越界、索引越界下标从0开始还是1开始搞混统一检查循环边界.jsxbin之外的脚本在报错时可以用try...catch包住关键段把e.message和e.line打到控制台比不断插alert效率高得多。另一个高频问题是脚本运行到一半报错前面的改动已经生效、后面的没执行工程处于半改状态。所以凡是要改工程结构的脚本都先用beginUndoGroup包起来出错时至少能一次撤销回去。5.2 脚本和插件在苹果M系列芯片上的兼容差别很多人问 ae插件苹果m4支持吗答案要分开看。AE脚本是纯文本由AE内置的解释器执行本身不涉及编译产物所以芯片架构对它没有影响同一份.jsx在 Intel 机器和 M 系列机器上跑起来表现一致。真正受架构影响的是插件尤其是带原生二进制模块的渲染类插件它们需要单独提供对应架构的版本通过 Rosetta 转译运行会明显变慢甚至崩溃。判断方法很直接AE 本身是原生运行还是通过转译运行决定了插件的运行环境。如果AE是原生版本那么加载旧架构插件就需要重启到转译模式代价是所有渲染都变慢。脚本层面完全不用操心这件事这也是自学脚本的一个隐藏优势——写出来的工具在团队里任何一台机器上都能用。5.3 用两个细节把脚本速度和可用性再提一档第一个细节是beginUndoGroup的作用范围要尽量小只包住真正改工程的部分。把遍历、读文件、弹对话框这些操作放在撤销组外面能显著减少AE维护撤销栈的开销长脚本上差异很明显。第二个细节是循环里别反复取同一个对象比如comp.layer(i).property(ADBE Opacity)写在三层循环内层每次都重新解析属性路径把属性对象提到循环外存成变量是标准优化。最后一个技巧是把脚本变成习惯动作把常用脚本放进Scripts/ScriptUI Panels/目录重启后在 Window 菜单里能找到再配合 AE 自己的快捷键设置面板给菜单项绑定组合键一次点击就能跑。更省事的办法是写一个总控面板脚本把十几个小功能做成按钮排成一行日常真正要用的是哪个一眼就能看到。本文还有配套的精品资源点击获取