Aseprite 命令行批处理教程（CLI 自动化）

一、命令行简介

Aseprite 提供了命令行界面（CLI），可以在不打开 GUI 的情况下批量处理文件：转换格式、生成 Sprite Sheet、导出动画等。对于需要批量处理大量资源的团队非常有用。

二、基本用法

Windows 命令行：

Aseprite.exe -b input.aseprite --save-as output.png

macOS/Linux：

aseprite -b input.aseprite --save-as output.png

-b 表示 batch 模式（不启动界面）。

三、批量转换格式

将当前目录所有 .aseprite 文件导出为 PNG：

# Windows
for %f in (*.aseprite) do Aseprite.exe -b "%f" --save-as "%~nf.png"

# macOS/Linux
for f in *.aseprite; do aseprite -b "$f" --save-as "${f%.aseprite}.png"; done

四、批量生成 Sprite Sheet

aseprite -b animation.aseprite ^
  --sheet sprite_sheet.png ^
  --data sprite_sheet.json ^
  --sheet-pack ^
  --sheet-padding 2 ^
  --format json-array

参数说明：

• --sheet：输出的图集图片
• --data：输出的 JSON 数据文件
• --sheet-pack：自动紧凑排列
• --sheet-padding：帧间距
• --format json-array：JSON 格式

五、缩放导出

aseprite -b input.aseprite --scale 2 --save-as output@2x.png

六、集成到构建流程

可以将 Aseprite CLI 写入脚本，在游戏构建时自动从 .aseprite 源文件生成最新的 Sprite Sheet：

// package.json 示例
{
  "scripts": {
    "build-assets": "bash export-sprites.sh",
    "build": "npm run build-assets && webpack"
  }
}

导入 Unity 或 Godot 的流程见对应教程。