CANN/runtime错误信息开发总纲

📅 2026/7/11 16:23:10
CANN/runtime错误信息开发总纲
Runtime Error Message 开发总纲【免费下载链接】runtime本项目提供CANN运行时组件和维测功能组件。项目地址: https://gitcode.com/cann/runtime本目录是 Runtime/ACL Error Message 整改和检视的统一规范来源面向开发者和 AI agent 共用。错误码、宏、错误文案和上报边界的规则应优先在本目录维护避免多个 skill 各自复制规则后产生口径漂移。资料结构文件用途rectification-principles.md判断整改边界、用户错误/内部错误、参数来源、第一现场、防御性编程、重复结构化上报和打印格式规范error-code-guide.md选择Runtime EE 与 ACL EH 错误码macro-selection-guide.md选择 ErrMsg外部/内部错误码上报宏message-examples.md查看 ErrMsg 文案模板、Arglist、典型表达和文案整改示例review-checklist.md检视 ErrMsg 修改是否合规重点核对 error_code.json / error_code_meta.h 双源同步、宏参数数量、错误文案语法和参数值使用方式判断是否应该整改、是否属于第一现场、是否重复上报以及确认防御性编程和打印格式要求时先读rectification-principles.md。选择或审查错误码时读error-code-guide.md涉及 ErrCode、ErrMessage、Arglist 和 suggestion 时以src/dfx/error_manager/error_code.json为准。选择或审查宏时读macro-selection-guide.md注意区分_INNER系列的 printf 风格参数和_OUTER系列的结构化参数。优化错误文案时读message-examples.md并结合error_code.json中的模板、Arglist 和rectification-principles.md中的打印格式规范。提交或评审 ErrMsg 修改前读review-checklist.md进行自检重点确认error_code.json与error_code_meta.h同步、%s与 Arglist 参数数量一致、宏调用未重复传参、suggestion 和 ErrMessage 文案满足格式要求。事实来源当规范文档与代码不一致时应以代码为准并同步修正规范文档。关键代码来源包括src/dfx/error_manager/error_code.jsonsrc/runtime/core/inc/common/error_code_meta.hsrc/runtime/core/inc/base.hppsrc/runtime/core/inc/common/error_message_manage.hppsrc/dfx/error_manager/error_manager.h维护原则本目录承载正式规范skill 只保留流程和导航不复制完整规则。修改错误码、宏或文案规范时同步检查本目录内相关文档是否需要更新新增或调整错误码时重点核对并更新error_code.json、error_code_meta.h和error-code-guide.md新增或调整上报宏时重点核对并更新macro-selection-guide.md。review-checklist.md面向检视和自检新增常见问题、参数计算规则或双源同步要求时应同步补充该清单。新增或调整 ErrMsg 调用点时不修改业务逻辑、返回值、条件判断和普通日志级别除非需求明确要求。【免费下载链接】runtime本项目提供CANN运行时组件和维测功能组件。项目地址: https://gitcode.com/cann/runtime创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考