目录
WPS AirScript 2.0和1.0的核心区别在于：2.0的API定义与WPS JS宏对齐、可用API更多，并支持async/await、Promise、class等现代JavaScript语法；1.0则更适合继续承载依赖数据表、邮件或数据库等既有能力的脚本。两者并非完全兼容，因此不能只把脚本版本号改成2.0后直接运行。
先看结论
| 你的情况 | 建议选择 |
|---|---|
| 新建以在线工作表为中心的自动化脚本，希望使用更完整的表格API和现代JavaScript | 优先考虑AirScript 2.0 |
| 现有脚本稳定运行，且依赖数据表、邮件或数据库相关能力 | 继续使用AirScript 1.0 |
| 准备迁移旧脚本，但尚未核对API参数、返回值和运行结果 | 先保留1.0脚本，再单独创建2.0副本逐项验证 |
AirScript是面向在线表格等场景的JavaScript脚本开发能力。这里的“升级”更接近运行时和API体系的大版本变化，而不是单纯增加几个函数。因此，选择版本时应先看脚本要操作的对象和所依赖的服务，再看语法与性能需求。
核心差异对比
| 对比维度 | AirScript 1.0 | AirScript 2.0 |
|---|---|---|
| API体系 | 参考WPS JS宏规范，但并非完全对齐 | API定义与WPS JS宏规范对齐 |
| 表格API规模 | 官方概览列为500+工作表API | 官方概览列为2000+工作表API |
| JavaScript语法 | 支持大部分ES6，但不支持class、async/await、Promise等部分现代特性 | 支持async/await、Promise、class等现代JavaScript语法 |
| 工作表场景 | 支持 | 支持，适合以工作表对象、单元格、区域和图表等为中心的开发 |
| 数据表场景 | 官方概览列为支持 | 官方概览列为待开放 |
| 高级服务 | 官方概览列出网络、云文档、邮件、数据库等能力 | 官方概览列出网络、云文档；邮件和数据库标为待开放 |
| 与旧脚本的关系 | 可继续运行 | 可兼容运行大部分1.0 API，但不能保证完全兼容 |
API与语法：2.0更适合新脚本
API定义更接近WPS JS宏
AirScript 2.0的一个关键变化是与WPS JS宏API规范对齐。对于计划同时理解或复用WPS JS宏相关对象模型的开发者，这能减少API命名和调用方式上的切换成本。官方说明中，2.0工作表API数量为2000+，而1.0为500+；这意味着2.0在工作表自动化场景中可调用的对象和方法范围更广。
现代JavaScript写法可用，但迁移时不能照搬旧逻辑
1.0文档明确列出了不支持的部分语法，包括class、对象方法简写、import/export、可选链和await等。2.0则支持async/await、Promise与class，适合将较复杂的异步流程、业务逻辑和代码结构组织得更清晰。
不过，语法升级不代表旧代码必然无须调整。两版在少数API的参数、返回值类型和调用方式上可能存在冲突。尤其是旧脚本中涉及范围对象、集合对象或返回值判断的部分，应对照对应版本的API文档逐项检查。
能力边界：数据表与高级服务决定是否暂留1.0
如果你的脚本只是在在线工作表中批量读写单元格、整理格式、处理筛选结果或生成图表，2.0通常更符合后续开发方向。相反，如果脚本依赖数据表能力，或工作流中要使用邮件、数据库等高级服务，就不能仅因2.0的API更多而贸然替换。
官方概览将2.0的数据表API、邮件API和数据库API标为待开放，而1.0列有对应能力。因此，个人用户做轻量表格自动化、教师处理课程数据、团队整理共享表格时，可优先评估2.0；组织内已有通知、数据同步或业务表驱动脚本时，则应先盘点服务依赖。
如果你的实际目标是用自然语言辅助解读表格，而不是编写自动化脚本，可另看WPS AI数据分析怎么用，它与AirScript的代码自动化路径不同。
性能差异要怎样理解
官方资料说明2.0对逻辑执行和API调用速度进行了优化，并以“循环处理1000个单元格文本”的示例说明，2.0在该示例中比1.0快1倍。这个结果只能用于理解官方示例所展示的优化方向，不能直接推断任何脚本都会获得相同比例的提升。
实际运行时间还会受循环次数、读写频率、数据量、网络请求、脚本服务调用和表格复杂度影响。对于大型脚本，更稳妥的做法是保留相同输入数据与相同业务逻辑，在两个版本的独立脚本中分别运行并比对日志、结果和耗时。
从1.0迁移到2.0的稳妥步骤
- 盘点依赖。列出脚本正在使用的工作表API、数据表API、高级服务和外部请求；先确认是否依赖2.0尚未提供的能力。
- 复制而非覆盖。保留可用的1.0脚本，新建一份2.0版本副本进行修改，避免影响既有自动化流程。
- 切换到2.0文档核对。重点检查报错位置附近的对象名、参数顺序、可选参数、返回值类型与枚举值，不要混用1.0和2.0文档示例。
- 先用小范围数据验证。例如只处理一个工作表或少量行列，确认写入内容、格式和异常分支正确后，再扩大执行范围。
- 保留回退方案。在2.0版本尚未覆盖所需服务或结果存在差异时，继续让生产脚本运行在1.0环境。
示例场景：某教师维护一份在线成绩表，原1.0脚本只做单元格清洗、计算和格式标记，没有使用数据表、邮件或数据库服务。可以复制脚本后在2.0中按新版API文档核对，再用一小组学生数据确认结果一致。若脚本还会自动发送成绩通知，则应先确认所需邮件能力是否可用。
常见问题
AirScript 1.0还能继续用吗？
可以。官方说明保留了1.0运行时环境，以确保原有脚本不受影响；1.0和2.0是相互隔离的运行环境。已有脚本能稳定完成任务时，不必为了版本号而立刻迁移。
为什么同一段代码在2.0里提示API不存在或结果不一样？
先确认脚本运行时版本与查阅的API文档版本是否一致。1.0与2.0并非完全兼容，少数API可能在参数、返回值类型或用法上存在定义冲突。不要把1.0文档中的示例直接视为2.0的通用写法。
2.0是不是一定比1.0更快？
2.0有面向逻辑执行和API调用的优化，官方示例也展示了速度提升；但不同脚本的瓶颈不同。涉及网络服务、复杂计算或大量文档操作时，仍应以自己的脚本结果为准。
怎样识别脚本属于1.0还是2.0？
官方说明中，脚本列表的版本标识会区分两者：1.0脚本显示“1.0”，2.0脚本显示“Beta”。客户端或网页端的入口与标识样式可能随版本变化，请以当前界面显示为准。
验证情况与使用说明
本文依据相关品牌的官方帮助资料整理。具体功能入口、规则名称和可选样式可能随系统、地区、账号与版本变化，请以当前客户端或官方页面显示为准。本页为第三方使用教程，并非相关品牌的官方帮助页面。