简介这份《Cadence Skill语法详解中文》收集版是一份面向芯片设计与版图工程师、EDA工具二次开发人员的中文语法参考适合需要批量处理版图、仿真或定制Cadence环境下脚本流程的初学者和进阶用户。资源仅含1个PDF文档压缩包大小409KB内容精炼便携方便在开发时快速查阅语法规则。目前已有144人浏览学习。正文围绕SKILL语言核心展开从常量、变量与算术逻辑操作符到if/when/cond、while/for/foreach等条件与循环控制再到正则表达式匹配、函数调用和prog局部变量/return返回值机制均有系统整理每个语法点都配有对应示例与简要说明能帮助读者摆脱零散英文帮助文档快速建立完整语法知识框架用于实际脚本编写与自动化方案落地。1. Cadence Skill 不是玩具脚本PCB/IC 自动化绕不过的那道坎在 Allegro 里给两百个元件批量加属性、把位号按网络整理成报告、或者给 DDR 走线做规则检查这些重复操作一旦超过一小时你就会开始认真考虑脚本化。Cadence Skill 是 Allegro PCB Editor 和 Virtuoso IC 设计工具内置的脚本语言语法上属于 Lisp 方言和常见的 Python 语法、C 语法完全不是一个路子也因此劝退了不少人。这篇笔记面向的是想真正上手 Skill 的硬件工程师和 EDA 开发把语法规则拆成能跑起来、能排错、能复用的实战路径。标题里那份中文收集文档我读过类似版本但真正的价值不在于背语法表而在于理解这套语法怎么和 Allegro 的数据库交互。2. Skill 语法骨架前缀表达式、变量与控制流怎么读2.1 前缀表达式与括号把运算顺序交给嵌套深度Skill 的表达式长这样( 1 2)、(axlGetSelSet)、(printf %s\n hello)。第一次看到这种写法的工程师多半会愣一下因为小学开始学的算术都是中缀写法。实际上前缀表达式的本质是操作符在前参数在后函数调用和运算符统一成同一种格式解析规则极其简单——没有优先级问题嵌套深度决定计算顺序。; 中缀习惯的写法在 Skill 里不存在 ; 正确写法是操作符前置 area (* 10 20) ; 计算 10*20 height (sqrt ( (* x x) (* y y))) ; 计算 sqrt(x^2 y^2) radius (car (3 4 5)) ; 取列表第一个元素 3这段代码的逻辑说明每一对括号都是一个表达式最外层括号内的第一个元素是操作符其余是操作数。sqrt、car都是函数(3 4 5)是包含三个元素的列表常量。参数可以继续嵌套表达式所以( (* x x) ...)这种写法非常常见。参数说明area变量不需要预先声明类型Skill 是动态类型语言赋值后自动确定类型car是取列表头元素来自 Lisp 传统。新手最容易绕晕的是赋值符号。Skill 里既是赋值运算符也是数值比较运算符。area 100在条件判断上下文里会被当作area 是否等于 100来解释而在表达式顶层则是赋值。这个二义性是 Skill 语法里最像语法糖又最坑的地方。我的习惯是赋值场景只在let块内部或函数体内使用数值比较一律写成字符串内容比较也用避开在哪一边生效的语义模糊区。2.2 变量与 let 作用域动态类型不是免死金牌Skill 里声明变量不需要类型关键字变量名直接赋值就存在了。但不用声明不等于没有作用域。全局变量和局部变量的分野非常严格写不好就是脚本互相污染。; 用 let 声明局部变量避免污染全局命名空间 procedure( calcImpedance( width thickness ) let((epsR h) epsR 4.3 h thickness ; 微带线近似公式这里只演示变量使用 (/ 87 (sqrt ( epsR 1.41))) ) )逻辑说明let括号内的列表(epsR h)声明了两个局部变量只在procedure内部可见。函数体由一组表达式组成最后一个表达式的值作为函数返回值。这里的(/ 87 ...)是除法表达式。参数说明epsR和h都只在函数内生效函数返回后自动释放如果你不想用let直接在函数体里给变量赋值那这个变量默认是全局的——同一名字可能覆盖其他脚本的同名变量这是 Skill 开发里极常见的事故源。习惯上Skill 社区约定全局变量用大写字母开头局部变量用小写字母开头。这不是语法强制的但是 Cadence 自己的示例代码和很多第三方库都遵循这个约定跟着做能省掉大量的排查时间。另外procedure是函数定义关键字calcImpedance( width thickness )定义了函数名和形参参数在函数体内直接用不需要再赋值一次。2.3 procedure 函数定义与控制流返回值是表达式的自然结果Skill 的控制流关键字很多常用的有if、when、unless、cond、for、foreach、while。它们都是 Lisp 式的前缀形式注意条件分支里的返回值概念和 C/Python 完全不同——Skill 里每个表达式都有值if的分支也返回该分支最后一个表达式的值。procedure( layerClassify( layerName ) if( layerName TOP then signal else if( layerName GND then power else other ) ) )逻辑说明if的第一个参数是条件表达式then后面是条件成立时的分支else后面是失败分支。layerName TOP是字符串内容比较注意必须使用。整个if表达式会返回匹配分支的值。参数说明字符串比较在 Skill 里用比较内容eq比较对象地址初学者常把两者混用后面避坑章节会展开。when和unless是if的简写when( cond body... )只有条件为真才执行没有 else 分支unless相反条件为假才执行。批量处理时foreach用得最多; 打印一组网络名 foreach( netName (VCC GND CLK DATA) printf( Net: %s\n netName ) )参数说明foreach遍历后面列表中的每个元素绑定到第一个变量上循环体内可以直接使用。printf的%s是字符串占位符%n是换行%d是整数%L可以打印任意对象的完整内容——调试时%L比%s好用得多它会把列表、关联表这类复杂结构完整展开。3. 列表与关联表Skill 数据结构里最常用的两件套3.1 列表构造list、引号列表与 cons/append 的差异Skill 的列表不是数组是链式结构。理解这一点很多性能坑和写法差异就能说通。构造列表有三种常见写法list()函数、引号简写()、以及cons在头部逐步拼装。a list( 1 2 3 ) ; 显式调用 list b (1 2 3) ; 引号简写等价于上者 c cons( 0 a ) ; 在头部加元素结果为 (0 1 2 3) d append( a (4 5) ) ; 拼接两个列表结果为 (1 2 3 4 5) printf( car%L cdr%L\n car(c) cdr(c) ) ; 输出car0 cdr(1 2 3)逻辑说明car取列表第一个元素cdr取剩余部分组成的列表。cons把新元素加到列表头部效率是 O(1)append需要遍历整个第一个列表效率 O(n)。参数说明如果你构建一个包含几千个元素的列表循环里反复用append会明显卡顿正确的做法是倒序cons最后加一次reverse。%L打印列表时不会像%s那样报类型错误排查数据结构内容非常实用。访问列表元素用nthnth( 2 (10 20 30) )返回 30下标从 0 开始。取最后一个元素可以用last判断元素是否在列表里用member注意member返回的是从匹配位置开始的子列表不是布尔值所以用when( member(...) ... )来判断是安全的非 nil 即真。3.2 嵌套列表与关联表用 assoc 实现配置映射Skill 里没有字典或哈希表这样的独立类型键值映射用嵌套列表实现术语叫关联表association list。每条记录本身也是列表整体是列表的列表。Cadence 的很多 API 返回值就是这个结构比如axlGetSelSet()返回选中的对象列表每个对象是一个 dbid 记录。; 元件封装映射表封装名 - 类型 map list( list( R0402 RES ) list( C0603 CAP ) list( L0805 IND ) ) ; 查表 result assoc( C0603 map ) when( result printf( C0603 is %s\n cadr(result) ) )逻辑说明assoc在关联表里查找键匹配的记录找到返回整条记录例如(C0603 CAP)找不到返回 nil。cadr取记录的第二项即映射的值。注意assoc比较的是字符串内容还是的那套语义。参数说明如果要映射的值是多个属性每条记录可以继续扩展成( R0402 RES 0.1W )取值时用cadr、caddr或者nth按需取用。这种结构虽然查询复杂度是 O(n)但 PCB 设计场景里封装种类通常几十到几百条性能完全够。真正的好处是结构透明直接用printf或print就能看到全部内容比黑匣子式的对象结构好排查得多。3.3 foreach 与映射式编程批量处理数据对象的习惯Skill 的核心用法就是批量遍历数据库对象。Allegro 的数据库对象常见类型有元件dbid、网络、焊盘、走线。访问对象属性统一用-操作符比如item-refdes取元件的位号。先看一个遍历列表改属性的场景; 给选中的元件添加自定义属性 procedure( addUserProp( propName propValue ) let((selList items) selList axlGetSelSet() foreach( item selList when( item-refdes axlDBAddProp( item propName propValue ) printf( Added %s%s to %s\n propName propValue item-refdes ) ) ) printf( Total %d items processed\n length(selList) ) ) )逻辑说明axlGetSelSet()是 Allegro 的扩展函数返回当前画布中选中的所有对象。foreach逐个取出对象when( item-refdes ... )判断这个对象是否有位号属性——只有元件才有避免对走线、铜皮这些对象误操作。axlDBAddProp是 Allegro API给数据库对象添加自定义属性。参数说明propName是属性名propValue是属性值printf里的三个%s分别对应后面的参数这是 Skill 里格式化输出的标准做法。映射式编程的思路是对集合中每个元素做一件事和一般的 for 循环区别在于不需要手动维护下标、不需要判断越界。实际操作中处理成百上千个对象时用foreach配合when过滤比嵌套if和for干净得多也少了很多下标类型的坑。如果要在遍历过程中收集结果用mapcar函数更优雅mapcar( (lambda (x) ...) 列表 )返回新列表不影响原列表。4. 从语法到落地在 Allegro 里加载 .il 脚本并操作设计对象4.1 运行环境Skill 命令行、load 与 allegro.ilinit 的加载路径语法学得再多落不到 Allegro 里都是纸上谈兵。Skill 脚本在 Allegro 里有三种加载方式在命令行窗口直接输入单条表达式、用load函数加载整个文件、放在用户初始化脚本里开机自动加载。; 在 Allegro 命令行逐行输入 axlGetSelSet() ; 显示当前选中对象 load( C:/work/myTools/refdes_dump.il ) ; 加载脚本文件 ; 或者把 load 写进 allegro.ilinit ; allegro.ilinit 通常位于 %USERPROFILE%/pcbenv/ 目录 ; load( C:/work/myTools/refdes_dump.il )逻辑说明load是 Skill 的内置函数接受文件路径字符串逐行解析执行文件内容。脚本文件扩展名通常用.il这是 Skill 的通用扩展名。参数说明路径里的正斜杠/在 Windows 下也能用反斜杠在 Skill 字符串里需要转义写起来很痛苦所以建议统一用正斜杠。allegro.ilinit是 Allegro 每次启动自动加载的 Skill 配置文件把公共函数放进去相当于给整个环境预装工具库。验证环境是否正常的标准动作是在命令行输入getVersion()或print(hello)如果能回显版本号或字符串说明解释器在工作。如果命令行的 Skill 模式没开启检查环境变量和安装版本——Allegro 的 Skill 是内置的解释器不需要额外安装运行时。4.2 第一个实用脚本选中元件输出位号到文本文件把上一章的列表遍历和文件操作合到一起就能写出一个很有实用价值的工具把选中元件的位号批量导出到文本文件供报告或后续脚本使用。procedure( dumpRefdes( optional (path refdes_list.txt) ) let((selList fp count) selList axlGetSelSet() count 0 when( selList fp outfile( path w ) foreach( item selList when( item-refdes fprintf( fp %s\n item-refdes ) count count 1 ) ) close( fp ) printf( Wrote %d refdes to %s\n count path ) ) ) )逻辑说明optional是 Skill 的可选参数声明调用时可以不传参使用默认值refdes_list.txt。outfile( path w )以写模式打开文件返回文件句柄fprintf相当于把printf的输出写到句柄指向的文件里close关闭文件。count累加实际写入的元件数最后打印汇总。参数说明when( selList ... )是把 nil 当作假值的典型用法——如果没有选中对象axlGetSelSet()返回 nil整个块跳过避免写空文件。这个脚本验证时先在 Allegro 里框选若干元件然后命令行输入dumpRefdes()或dumpRefdes(C:/tmp/refs.txt)检查输出文件内容。如果得到的行数和选中数量不一致多半是选区内混入了非元件对象已经被when( item-refdes ... )过滤掉了——这是预期行为不是 bug。4.3 调试与热加载printf 断点法与 error 关键字的合理使用Skill 没有单步调试器至少在 Allegro 的标准环境里没有我一般用三招定位问题。第一招是printf断点法在函数入口、循环内、可疑分支各加一行带变量内容的printf通过观察输出来判断执行路径和变量值。第二招是error主动抛错在逻辑上不应该执行到的位置放一个error(unexpected branch)一旦触发就立刻停在错误上比静默返回错误值好排查得多。第三招是热加载修改脚本后直接重新load一遍新函数定义会覆盖旧定义。procedure( debugDemo( x ) printf( Enter debugDemo, x%L\n x ) when( x nil error( x is nil, abort! ) ) ; 其他逻辑... printf( Leave debugDemo\n ) )逻辑说明printf的%L对 nil、列表、字符串都能安全打印不会因为类型不匹配报错。error会让脚本终止并弹出错误对话框同时把错误信息输出到命令行窗口。参数说明when( x nil ... )用于参数校验防止后面的代码拿到非法输入继续执行产生更隐蔽的问题。这里 nil判断的是值不是 nil对于空字符串它不等于 nil这是 Skill 语义里很重要的一点——空字符串是个真实的值不是空。热加载的注意点如果allegro.ilinit里已经有同名函数的load语句再次手动load新版本即可不需要重启 Allegro。但如果函数内部用了全局变量来存状态旧值会残留重新加载前先unset或重新初始化这些全局变量。5. Skill 语法避坑笔记括号、nil、作用域与中文注释的五条实录5.1 括号匹配失败加载脚本时报错或者莫名消失的代码现象写一个几十行的.il文件load时报语法错误错误提示指向文件末尾却看不出问题严重时括号不配对解释器把后续所有代码都吞进一个表达式里或者文件加载成功但函数没有定义。原因Skill 语法里括号就是一切少一个右括号解释器会认为表达式还没结束文件末尾的代码全都变成待闭合的参数。解决加载前先数括号属于心理安慰更靠谱的办法是用支持括号高亮和括号匹配的编辑器比如 VS Code 或 Notepad。写完一个procedure立刻进行一次局部括号配对检查而不是整个文件写完再查。如果提示文件末尾语法错误先看最后一个procedure的结束括号是否完整。所有参数都配对后命令行再执行一次load并通过who( 函数名 )确认函数已注册。提示加载失败的瞬间不要急着改代码先用计数方式快速定位层级。大多时候问题不在逻辑而在括号。5.2 nil 与空字符串混用条件判断和字符串拼接双双翻车现象从数据库属性里取到空值时想判断没取到用了if( value )结果没进分支拼接字符串时出现多余的 nil 字样。原因Skill 里 nil 表示没有值空字符串是值的内容为空两者不相等。数据库属性不存在时返回 nil属性存在但值为空时返回语义不同。解决判断属性是否存在用if( value nil )判断内容为空用if( value )更稳妥的写法是if( value )——只有 nil 为假和0都是真。字符串拼接用strcat时先判断 nil 再拼不要直接把 nil 拼进字符串。5.3 变量作用域泄漏一个函数改了另一个函数的数据现象两个脚本先后运行第二个脚本的输出和预期不一致或者同一个函数反复调用后结果越来越怪。原因函数体里直接给变量赋值没有let声明变量变成全局的。两次调用之间其他脚本也可能改了同名的全局变量。解决函数内部所有临时变量全部放进let列表里函数外部需要共享的数据才用全局变量并按照社区惯例用大写开头命名以区别于局部变量。排查时可在可疑函数里加一段printf打印变量名和值看看是否在被外部修改。5.4 中文注释乱码脚本能跑但注释变问号现象从网上或同事那里拿到的含中文注释的.il文件加载后注释显示乱码极少数情况直接触发解析错误。原因Skill 脚本文件的编码和当前操作系统的代码页不一致。Allegro 的老版本对 UTF-8 支持不完善Windows 下默认可能按 GBK 解析反过来 UTF-8 文件被当成 GBK 读中文就变问号。解决脚本文件统一存成 UTF-8 无 BOM注释和字符串里的中文尽量少用如果遇到旧版本工具把文件转成 ANSI 编码再加载。我的做法是关键提示写在代码里用英文长说明放到单独的中文文档里脚本本身的注释只保留三五个英文关键词。5.5 字符串比较用了单等号逻辑不报错但行为错乱现象if( layerName TOP )没有语法错误但条件恒真所有图层都被当成 TOP 处理。原因在 Skill 里有赋值语义layerName TOP先把TOP赋给layerName然后整个表达式返回赋的值TOP非 nil 即真所以恒真。解决字符串比较一律用仅在处理数字等值判断时按场景使用并在写完代码后全局搜索一遍文件里的单等号逐个确认语义。写 C 写多了会顺手用写 Python 写多了会下意识用Skill 的双符号规则其实很一致——赋值或比较数字比较内容宁可多敲一个符号也别省。6. 把语法练成肌肉记忆自检脚本与快捷键绑定的实战习惯语法看十遍不如跑三遍。我通常的做法是维护一个sandbox.il文件专门用来测试新写的函数文件末尾放一组构造好的边界输入比如空列表、nil、空字符串、大型列表每次修改语法或逻辑后重新加载并运行观察printf输出是否符合预期。这比在 Allegro 里手工找一个真实对象来点击验证快得多也更容易覆盖边界条件。写好的函数可以绑定到快捷键上。常见做法是在allegro.ilinit里加一行axlAlias( F8 dumpRefdes )保存后重启 Allegro按 F8 就等于执行dumpRefdes()。如果想保留命令行参数把函数封装成无参版本内部调用带参版本procedure( dumpRefdesByHotkey() dumpRefdes( C:/work/output/refdes_dump.txt ) )axlAlias的第二个参数是命令字符串可以是 Skill 函数名注意这里的dumpRefdesByHotkey不能带括号让它作为命令别名注册。重启后按 F8即可一键导出当前选中的位号。这种方式和写 playwright 自动化脚本的调试循环很像——每改一小步就重跑一次只不过这里不需要浏览器只需要load一下脚本。我最开始的 Skill 脚本经常犯低级错误要么忘了括号要么把和混用后来养成了固定的验证路径先写独立函数加printf入口日志再放到sandbox.il跑边界数据最后才接真实的 Allegro 对象。这套流程帮我少踩了很多坑也把 Skill 语法从看着像 Lisp变成了闭着眼能写。希望帮到你。本文还有配套的精品资源点击获取