unity-test-runner

Unity Test Runner 是一款专为 Unity 游戏开发设计的技能，旨在直接从命令行简化质量保证流程。此工具服务于需要将自动化测试集成到本地工作流程或 CI/CD 流水线中的 Unity 开发人员与工程师。通过自动化整个测试生命周期，它减少了因重复测试周期而需打开 Unity Editor 图形界面所带来的繁琐操作。此工具在验证游戏逻辑、调试回归错误以及在提交前确保项目稳定性方面特别有效。

• 自动检测跨 Windows、macOS 和 Linux 平台的 Unity Editor 安装，并支持多种 Unity 版本。

• 支持在 EditMode 或 PlayMode 下执行测试，适用于快速单元测试或全面的引擎级集成测试。

• 支持高级测试过滤与分类，开发人员可选择执行特定子集的测试，例如 Combat、AI 或 Physics 模块。

• 解析由 Unity Test Framework 生成的 NUnit 兼容 XML 结果，提供结构化的摘要统计与失败诊断信息。

• 生成详细且具备行动建议的失败报告，包含完整的堆栈跟踪、源代码文件位置与行号，以利快速定位错误。

• 通过标准命令行参数与 shell 工作流程无缝集成，支持项目路径、日志输出与测试结果导出。

• 在尝试执行前，请务必确认 ProjectSettings/ProjectVersion.txt 与 Assets 目录的存在，以确保项目路径有效。

• 若本地安装有多个版本，请使用 find-unity-editor.js 脚本列出并选择适当的 Editor 版本。

• 建议使用 --json 参数以利程序化读取检测与测试分析脚本的输出结果。

• 执行测试时可使用后台进程监控；针对长时间运行的 PlayMode 测试，请设置适当的超时时间以避免过早中止。

• 此工具适用于已安装 Unity Editor 且可通过标准 CLI 路径访问的开发环境。