告别手动截图！写一个Unity编辑器工具，自动导出Sprite Editor切割好的所有子图片

Unity自动化工具一键导出Sprite Editor切割的所有子图片每次在Sprite Editor里精心切割完图集后最痛苦的事情莫过于要手动导出每一张小图。作为开发者我们明明可以编写一个自动化工具来解放双手。今天我们就来打造一个功能完善的Unity编辑器扩展不仅能自动导出所有子图片还会加入进度显示、异常处理和多种导出格式支持。1. 准备工作与环境配置在开始编写工具之前我们需要确保Unity项目已经正确设置。首先导入你需要处理的图片资源到Assets文件夹中。右键点击图片在Inspector面板中进行以下设置Texture TypeSprite (2D and UI)Sprite ModeMultipleAdvanced→Read/Write Enabled勾选提示如果Read/Write未启用脚本将无法访问像素数据导致导出失败。接下来点击Sprite Editor按钮使用自动或手动方式切割图片。常用的切割方式有Automatic适用于规则排列的精灵图Grid By Cell Size按固定尺寸切割Grid By Cell Count按行列数切割Isometric等距视角专用切割完成切割后别忘了点击Apply保存设置。现在我们的图片已经准备好被脚本处理了。2. 核心导出功能实现创建一个新的C#脚本放在Editor文件夹下命名为SpriteExporter.cs。我们将从基础功能开始逐步完善这个工具。using UnityEngine; using UnityEditor; using System.IO; using System.Linq; public class SpriteExporter : EditorWindow { [MenuItem(Assets/Sprite Exporter/Export All Slices)] static void ExportAllSlices() { // 获取当前选中的纹理 Texture2D selectedTexture Selection.activeObject as Texture2D; if (selectedTexture null) { Debug.LogError(请选择一张图片!); return; } string assetPath AssetDatabase.GetAssetPath(selectedTexture); TextureImporter textureImporter AssetImporter.GetAtPath(assetPath) as TextureImporter; // 确保纹理可读 textureImporter.isReadable true; AssetDatabase.ImportAsset(assetPath); // 创建输出目录 string outputDir Path.Combine(Path.GetDirectoryName(assetPath), selectedTexture.name _Slices); Directory.CreateDirectory(outputDir); // 处理每个子精灵 foreach (SpriteMetaData spriteMeta in textureImporter.spritesheet) { ExportSingleSprite(selectedTexture, spriteMeta, outputDir); } AssetDatabase.Refresh(); EditorUtility.DisplayDialog(导出完成, $所有子图片已导出到: {outputDir}, 确定); } static void ExportSingleSprite(Texture2D sourceTexture, SpriteMetaData metaData, string outputDir) { // 实现单个精灵的导出逻辑 } }这段代码创建了一个基本的导出框架接下来我们需要实现ExportSingleSprite方法来完成实际的像素数据提取和保存。3. 像素数据处理与优化在ExportSingleSprite方法中我们需要处理以下几个关键点像素数据提取根据SpriteMetaData中的rect信息获取对应区域的像素格式转换确保纹理格式兼容EncodeToPNG/EncodeToJPG透明通道处理正确处理带alpha通道的图片性能优化避免频繁的内存分配static void ExportSingleSprite(Texture2D sourceTexture, SpriteMetaData metaData, string outputDir) { Rect rect metaData.rect; int width (int)rect.width; int height (int)rect.height; // 创建临时纹理 Texture2D spriteTexture new Texture2D(width, height, TextureFormat.ARGB32, false); // 提取像素数据 Color[] pixels sourceTexture.GetPixels( (int)rect.x, (int)rect.y, width, height ); spriteTexture.SetPixels(pixels); spriteTexture.Apply(); // 处理透明通道 if (HasTransparency(pixels)) { spriteTexture.alphaIsTransparency true; } // 保存文件 string outputPath Path.Combine(outputDir, ${metaData.name}.png); File.WriteAllBytes(outputPath, spriteTexture.EncodeToPNG()); Object.DestroyImmediate(spriteTexture); } static bool HasTransparency(Color[] pixels) { return pixels.Any(c c.a 1.0f); }这个实现已经可以正常工作但对于大图集或高分辨率图片可能会遇到性能问题。我们可以通过以下方式优化使用Texture2D.GetPixels32替代GetPixels减少内存占用实现进度条显示让用户了解导出进度添加异常处理防止程序崩溃4. 增强功能与用户体验一个专业的编辑器工具应该考虑用户体验和健壮性。让我们为工具添加以下增强功能4.1 进度显示与取消操作长时间操作时显示进度条不仅能提升用户体验还能让用户有机会取消操作。[MenuItem(Assets/Sprite Exporter/Export All Slices)] static void ExportAllSlices() { // ...之前的代码... try { int total textureImporter.spritesheet.Length; for (int i 0; i total; i) { // 检查用户是否取消了操作 if (EditorUtility.DisplayCancelableProgressBar( 导出子图片, $正在处理 {i1}/{total}: {textureImporter.spritesheet[i].name}, (float)i / total)) { break; } ExportSingleSprite(selectedTexture, textureImporter.spritesheet[i], outputDir); } } finally { EditorUtility.ClearProgressBar(); } // ...之后的代码... }4.2 导出格式选择不同场景可能需要不同的图片格式我们可以让用户选择导出PNG或JPG。public enum ExportFormat { PNG, JPG } [MenuItem(Assets/Sprite Exporter/Export All Slices)] static void ExportAllSlices() { // 添加格式选择对话框 if (EditorUtility.DisplayDialog(选择导出格式, 请选择导出的图片格式, PNG (无损), JPG (有损))) { ExportWithFormat(ExportFormat.PNG); } else { ExportWithFormat(ExportFormat.JPG); } } static void ExportWithFormat(ExportFormat format) { // 修改导出逻辑以支持不同格式 }4.3 异常处理与日志完善的错误处理能让工具更加健壮也便于调试问题。static void ExportAllSlices() { try { // ...导出逻辑... } catch (System.Exception e) { Debug.LogError($导出失败: {e.Message}); EditorUtility.ClearProgressBar(); EditorUtility.DisplayDialog(错误, $导出失败: {e.Message}, 确定); } }5. 高级功能扩展基础功能完成后我们可以考虑添加一些高级特性让工具更加强大。5.1 批量处理多张图片修改工具使其能够同时处理多张选中的图片大幅提升工作效率。[MenuItem(Assets/Sprite Exporter/Export All Slices, true)] static bool ValidateExportAllSlices() { // 验证是否选中了纹理资源 return Selection.objects.All(o o is Texture2D); } [MenuItem(Assets/Sprite Exporter/Export All Slices)] static void ExportAllSlices() { foreach (Texture2D texture in Selection.objects.OfTypeTexture2D()) { // 对每张选中的图片执行导出 ExportSingleTexture(texture); } }5.2 自定义命名规则允许用户自定义导出图片的命名规则满足不同项目的需求。static string GetOutputFilename(string baseName, SpriteMetaData metaData, ExportFormat format) { // 实现自定义命名逻辑 return ${baseName}_{metaData.name}.{format.ToString().ToLower()}; }5.3 纹理压缩设置导出时自动应用适合的纹理压缩设置减少最终文件大小。static void ApplyTextureSettings(string path, ExportFormat format) { TextureImporter importer AssetImporter.GetAtPath(path) as TextureImporter; if (importer ! null) { importer.textureCompression TextureImporterCompression.Compressed; importer.crunchedCompression true; importer.compressionQuality 50; if (format ExportFormat.JPG) { importer.textureType TextureImporterType.Default; } AssetDatabase.ImportAsset(path); } }6. 工具集成与发布完成核心功能后我们需要考虑如何将这个工具更好地集成到Unity编辑器中。6.1 自定义编辑器窗口创建一个专门的编辑器窗口提供更多选项和可视化控制。public class SpriteExporterWindow : EditorWindow { private ExportFormat exportFormat ExportFormat.PNG; private bool createSubfolder true; [MenuItem(Window/Sprite Exporter)] static void ShowWindow() { GetWindowSpriteExporterWindow(Sprite Exporter); } void OnGUI() { GUILayout.Label(导出设置, EditorStyles.boldLabel); exportFormat (ExportFormat)EditorGUILayout.EnumPopup(导出格式, exportFormat); createSubfolder EditorGUILayout.Toggle(创建子文件夹, createSubfolder); if (GUILayout.Button(导出选中图片)) { ExportSelectedTextures(); } } void ExportSelectedTextures() { // 实现导出逻辑 } }6.2 上下文菜单集成通过添加[MenuItem]属性我们可以将功能集成到右键菜单中。[MenuItem(CONTEXT/TextureImporter/Export Slices)] static void ExportSlicesContextMenu(MenuCommand command) { TextureImporter importer command.context as TextureImporter; if (importer ! null) { Texture2D texture AssetDatabase.LoadAssetAtPathTexture2D(importer.assetPath); ExportSingleTexture(texture); } }6.3 打包为UnityPackage为了方便团队共享或发布到Asset Store我们可以将工具打包。创建一个文件夹结构Assets/SpriteExporter/Editor将所有相关脚本放入Editor文件夹创建package.json文件在Unity中选择Assets → Export Package7. 性能优化与最佳实践随着功能的增加我们需要确保工具保持良好的性能。7.1 内存管理纹理处理可能消耗大量内存需要特别注意及时销毁临时创建的Texture2D对象使用using语句管理文件流避免在循环中频繁创建新对象static void ExportSingleSprite(Texture2D sourceTexture, SpriteMetaData metaData, string outputDir) { // ...之前的代码... // 使用完后立即销毁纹理 Object.DestroyImmediate(spriteTexture); }7.2 异步处理对于非常大的图集可以考虑使用异步处理避免编辑器卡死。static IEnumerator ExportAsync(Texture2D texture, string outputDir) { // 实现异步导出逻辑 yield return null; }7.3 缓存机制如果频繁导出相同的图片可以添加缓存机制避免重复处理。static Dictionarystring, DateTime lastExportTimes new Dictionarystring, DateTime(); static bool NeedsExport(string texturePath) { // 检查是否需要重新导出 return true; }8. 实际应用案例让我们看几个这个工具在实际项目中的应用场景。8.1 角色动画图集处理假设我们有一个包含多个角色动画帧的图集在Sprite Editor中使用Grid模式切割运行导出工具获得所有动画帧的单独图片可以在其他软件中进一步编辑或直接使用8.2 UI元素分离当从设计师那里拿到包含多个UI元素的PSD导出图时在Unity中设置好每个UI元素的边界一键导出所有元素单独调整或替换特定元素8.3 纹理资源管理对于需要版本控制的团队项目导出所有子图片单独检入版本控制系统便于追踪每个小图的修改历史9. 常见问题解决在实际使用中可能会遇到的一些问题及其解决方案。9.1 导出图片颜色异常问题导出的图片颜色与原始图不一致原因可能是色彩空间或纹理格式不匹配解决方案// 确保使用正确的纹理格式 Texture2D spriteTexture new Texture2D(width, height, TextureFormat.RGBA32, false);9.2 透明区域显示不正确问题透明区域变成黑色或不透明原因未正确处理alpha通道解决方案// 设置alphaIsTransparency属性 TextureImporter importer AssetImporter.GetAtPath(path) as TextureImporter; importer.alphaIsTransparency true; AssetDatabase.ImportAsset(path);9.3 导出速度慢问题处理大图集时速度很慢优化建议使用GetPixels32替代GetPixels减少不必要的纹理格式转换分批处理非常大的图集10. 工具的未来扩展方向虽然当前工具已经相当实用但仍有改进空间支持更多图片格式如WEBP、TGA等智能重命名功能基于规则自动重命名导出文件预设系统保存常用导出配置与版本控制系统集成自动提交导出的文件批量重导入功能修改后自动重新导入所有子图这个工具的开发过程展示了如何将一个简单的需求逐步扩展为功能完善的编辑器扩展。从最初的简单脚本到现在的完整工具我们不仅解决了实际问题还提升了Unity编辑器的使用效率。