5.5 KiB
5.5 KiB
title, type, tags, date
| title | type | tags | date |
|---|---|---|---|
| Unity Editor Tool Developer | source | 2026-04-26 |
Source File
Summary（用中文描述）
- 核心主题：Unity Editor 扩展开发专家 Agent——通过 EditorWindow、PropertyDrawer、AssetPostprocessor、Build Validation 等自动化工具，减少团队手动操作时间、提前拦截错误
- 问题域：游戏项目 Editor 自动化工作流、美术/策划/程序团队的日常效率提升、构建前质量门控
- 方法/机制：Editor-only 代码规范（
Editor文件夹 /#if UNITY_EDITOR/ asmdef 隔离）→ 工具原型验证 → 量产化（含 Undo/ProgressBar/持久化）→ Build Validation 集成 - 结论/价值：提供完整的 Unity Editor 工具开发规范，包括 4 类核心 API（EditorWindow/PropertyDrawer/AssetPostprocessor/IPreprocessBuildWithReport）的代码模板与质量标准
Key Claims（用中文描述）
- 所有 Editor 脚本必须位于
Editor文件夹或使用#if UNITY_EDITOR守卫——Editor API 调用进入运行时程序集会导致构建失败 - AssetPostprocessor 必须幂等：同一资源导入两次必须产生相同结果
- PropertyDrawer.OnGUI 必须调用
EditorGUI.BeginProperty/EndProperty，否则 Prefab Override UI 将无法正常工作 - EditorWindow 工具必须通过
[SerializeField]或EditorPrefs持久化状态，否则 Domain Reload 后状态丢失 - 任何修改 inspector 显示对象的操作必须先调用
Undo.RecordObject，否则操作无法撤销，属于用户敌对行为 - 耗时超过 0.5 秒的操作必须显示
EditorUtility.DisplayProgressBar，否则 UI 会冻结
Key Quotes
"Every EditorWindow tool must persist state across domain reloads using
[SerializeField]on the window class orEditorPrefs" — Domain Reload 状态持久化规范 "Tools must show progress viaEditorUtility.DisplayProgressBarfor any operation taking > 0.5 seconds" — 长操作 UX 标准 "AssetPostprocessor must be idempotent: importing the same asset twice must produce the same result" — 导入处理器幂等性要求 "PropertyDrawer'sOnGUImust callEditorGUI.BeginProperty/EndPropertyto support prefab override UI correctly" — Prefab Override 支持规范 "Log actionable messages (Debug.LogWarning) when postprocessor overrides a setting — silent overrides confuse artists" — 静默覆盖之害
Key Concepts
- EditorWindow：Unity Editor 扩展窗口基类，通过
[MenuItem]注册菜单入口，可创建工具窗口、审计面板、检查器等 UI - PropertyDrawer：自定义 Inspector 属性绘制器，通过
CustomPropertyDrawer特性关联 Serializable 类型，提供更友好的编辑器编辑体验 - AssetPostprocessor：资源导入前置/后置处理器，在每次资源导入时自动触发，用于强制命名规范、导入设置和预算验证
- CustomEditor：自定义 Inspector 面板，通过
[CustomEditor(typeof(MyComponent))]替代默认组件检查器 - AssemblyDefinition（.asmdef）：Assembly Definition 文件，通过引 references 强制编辑器程序集与运行时程序集的编译时隔离
- Undo.RecordObject：
UnityEditor.UndoAPI，在修改对象前调用，使操作可撤销——不可撤销的编辑器操作属于用户敌对行为 - BuildValidation（IPreprocessBuildWithReport）：构建前验证接口，在打包前运行质量门控检查，失败时抛出
BuildFailedException - ScriptableBuildPipeline：Unity 可脚本化构建管线，替代传统构建流程，支持自定义构建任务（资产剥离/着色器变体/CDN 缓存失效）
- UI Toolkit（UIElements）：Unity 新一代编辑器 UI 系统，基于 USS + VisualElement，提供响应式、可样式化的编辑器 UI，替代 IMGUI
Key Entities
- UnityEditorToolDeveloper：Unity Editor 工具开发专家 Agent 自引用——"自动化痴迷、DX 优先、流水线第一、默默不可或缺"
Connections
- UnityEditorToolDeveloper ← authored_by ← TechnicalArtist（Technical Artist 可能审查或指导工具开发输出）
- EditorWindow ← enables ← UnityEditorToolDeveloper（EditorWindow 是构建工具窗口的核心 API）
- AssetPostprocessor ← enables ← UnityEditorToolDeveloper（AssetPostprocessor 是自动拦截错误资产的核心机制）
- PropertyDrawer ← enables ← UnityEditorToolDeveloper（PropertyDrawer 是改善 Inspector 体验的核心 API）
- UnityEditorToolDeveloper ← extends ← UnityShaderGraphArtist（Shader Graph Artist 依赖工具开发者构建编辑器辅助面板）
- UnityEditorToolDeveloper ← extends ← UnityMultiplayerEngineer（多人工程师依赖工具开发者构建网络调试窗口）
- UI Toolkit ← replaces ← EditorWindow（UI Toolkit 是 EditorWindow 的下一代演进方向）
Contradictions
- 与 UnrealTechnicalArtist 关于 Editor 扩展方案：
- 冲突点：Unity 使用 PropertyDrawer / CustomEditor / EditorWindow 方案，Unreal 使用 Details Panel Customization / EditorUtility / SWidget 方案
- 当前观点：Unity Editor Tool Developer 认为 PropertyDrawer + AssetPostprocessor 组合可覆盖 90% 的编辑器自动化场景
- 对方观点：Unreal Technical Artist 更偏好编辑器蓝图/编辑器模块化方案而非手写 C++
- 说明：两者均为各自平台的最佳实践，冲突源于引擎架构差异而非绝对优劣