共计 1534 个字符，预计需要花费 4 分钟才能阅读完成。

Allegro Skill 错误排查指南：新手入门避坑手册

1. 背景与痛点

Allegro Skill 是 Cadence Allegro PCB 设计软件中的脚本语言，用于自动化设计流程、提高效率。对于新手来说，由于不熟悉环境和语法，经常会遇到各种错误，导致开发受阻。

最常见的三类错误包括：

• 环境配置错误：Skill 路径设置不正确，导致脚本无法加载或运行。
• 语法错误：括号不匹配、变量未定义等基础语法问题。
• API 调用错误：参数类型错误、函数调用顺序不当等。

2. 错误诊断方法论

2.1 错误日志解读框架

当 Skill 脚本出错时，Allegro 会在命令行输出错误信息。一个典型的错误日志包含：

1. 错误类型（如语法错误、运行时错误）
2. 错误位置（文件名和行号）
3. 错误描述

例如：

*Error* eval: unbound variable - myVar

表示变量 myVar 未定义。

2.2 使用内置调试工具

Allegro 提供了 axlCmdRegister 函数，可以注册自定义命令，方便调试：

axlCmdRegister("my_debug" 'myDebugFunction)

然后在 Allegro 命令行输入 my_debug 即可调用该函数。

2.3 常见错误代码解释

• E-* (Error)：严重错误，脚本会立即终止。
• W-* (Warning)：警告，脚本继续执行但可能有问题。
• I-* (Info)：信息性消息，通常无害。

3. 典型错误案例

案例 1：环境变量设置错误

错误现象：脚本无法加载，提示 ”Could not find file”。

解决方法 ：检查allegro.ilinit 文件中的路径设置。正确示例：

setSkillPath(getSkillPath() "/path/to/your/scripts")

案例 2：列表操作越界错误

错误代码：

myList = list(1 2 3)
item = myList[3] ; 索引越界，有效索引是 0 -2

修复代码：

myList = list(1 2 3)
if length(myList) > 3 then
    item = myList[3]
else
    printf("Index out of bounds!\n")

案例 3：异步回调处理不当

错误实现：

axlSetFunCallback('myCallback)

正确实现：

axlSetFunCallback('myCallback t) ; 第二个参数 t 表示异步回调

4. 避坑指南

4.1 使用 lint 工具

推荐使用 skilllint 进行静态代码检查，可以捕获潜在问题。

4.2 API 防错模式

调用 API 时，始终检查返回值：

let((result)
    result = axlSomeFunction()
    when(result
        ; 处理成功情况
        printf("Operation succeeded\n")
        ; 否则
        printf("Operation failed\n")
    )
)

4.3 单元测试实践

为关键函数编写测试用例：

procedure(testAddNumbers()
    assertEqual(5 addNumbers(2 3))
    assertEqual(0 addNumbers(0 0))
)

5. 进阶建议

5.1 阅读官方文档

Cadence 提供了详细的 Skill API 文档，搜索时使用 ”Skill API [关键字]” 格式。

5.2 社区资源

• Cadence 官方论坛
• GitHub 上的开源 Skill 项目
• Stack Overflow 的 Allegro 标签

5.3 调试技巧总结

1. 使用 printf 输出中间值
2. 分步执行复杂操作
3. 编写小型测试用例验证假设

错误排查流程图

1. 重现错误
2. 查看错误日志
3. 定位错误位置
4. 分析错误原因
5. 修改代码
6. 测试修复
7. 如果未解决，回到步骤 1

自查问题

1. 我的脚本路径是否正确配置在 allegro.ilinit 中？
2. 我是否检查了所有 API 调用的返回值？
3. 我是否使用了 skilllint 检查了代码？