
前几天首发了《ANSA 从入门到精通(2026 版)》,得到了一致好评。


然后群里的老板就问有没有二次开发的相关教程,也就整理了这边书。
这本书分为4 篇,10 章,85 节,133 页 PDF,136 段代码,36 张界面截图,41 张速查表。
结构上是四段,跟着一个工具从无到有的过程走。
所有代码都在 ANSA 2026.1 上跑过。跑不通的我没删,留在书里标了原因,因为报错本身也是要学的东西。

官方文档很全。函数签名、参数、返回值列得清清楚楚,autocomplete 存根里连每个方法的定义都能翻到。问题在于它按功能分类,你按任务找东西,中间隔着一层。
真正卡住人的,常常是一串看起来都对、跑起来没反应的代码。这些地方我全踩过,也都写进去了。
插件装好了,Plugins 面板里没有按钮。原因通常不在插件本身。ANSA 的 Plugins 标签页是个空壳,内容全靠当前 profile 那份 gui/ANSA.xml 填。2026.1 自带 40 个 .ppl,39 个有按钮定义,唯一空着的是官方模板 test.ppl;而每个 profile 的 Toolbars_Plugins 里只登记了三五条。没登记的插件,装进去也不会出现。8.3 节给了手动补一条 Ribbon 条目的完整写法,也讲了 id、action_id、action 三个属性各管什么,改错一个会出现什么现象。

远程控制连不上,脚本满屏 Trying to connect,卡三分钟才报错。IAPConnection 内部是个 while retry,except 里又把 retry 设回 True,没有退出条件,走到第 60 轮才抛 EnvironmentError。多数时候的原因是启动 ANSA 时没带 -listenport。9.7 节把那段源码摘出来对着讲,另外给了三行端口自检,连不上立刻就知道,不用干等。
探测能力的那段代码一运行就闪退,可输出窗口里结果是对的。ImportV1 带内部状态,同一个进程里第二次实例化必崩,退出码 -1073741819,还会留下 dmp 文件。24.1.5 和 2026.1 都能复现。9.9 节把它改成纯 hasattr 判断,不碰实例化。
还有几个更小的。-execscript 在 Windows 上通过 ansa64.bat 传不进去,因为 bat 里那句 for %%x in (!BETA_ARGS!) 会把竖线当成管道;load_script 加载脚本时 __name__ 就是 __main__,文件底部那句 if __name__ 判断会直接命中,main() 被跑两遍;ANSA 默认装在 AppData\Local\Apps 下,不是 Program Files,一堆抄来的路径在这里就断了。
这些内容文档里不会有,因为文档默认一切顺利。

前面九章是零件,第 10 章是整车。四个案例由浅入深,覆盖了全书大部分知识点。
模型体检报告,拿到别人做的模型,三分钟看清有多少单元、多少自由边、有没有重复单元、Property 有没有漏配材料。Property / Material 规范化,按规则批量改名字、配材料、对厚度,改之前先出一份变更清单,跑一遍 DRY_RUN 确认了再落盘。
批量前处理流水线,无头模式拉起 ANSA,一个目录一个目录地跑,跑完写日志汇总,夜里挂着,早上来看结果。厚度云图查看器是带界面的小工具,选一个组件,按厚度上色,哪里厚哪里薄一眼就看出来。
每个案例都拆成采集层、检查层、报告层。想加一项检查只动检查层,想换一种输出只动报告层,这个结构比代码本身值钱。四个案例的骨架都能直接拿去改成自己的。
完全没有 Python 基础的,从第 1 章老实往下走,第一天能跑通第一个脚本,一周能把第 4 章的实体操作过一遍。
写过 Python、只是想接 ANSA 的,跳过第 2 章,从第 3 章的 Deck 机制看起。这一节没看懂,后面所有代码都会时灵时不灵,因为 base.CurrentDeck() 和写死 constants.NASTRAN 的差别,要到很后面才会咬你一口。
只想给同事做个工具的,第 6 章做按钮,第 7 章做窗口,第 8 章打包,三章连着看,一周能交一个能用的东西出去。
每节末尾有练习。答案书里不给,都在 API 里,自己试出来的印象最深。
网页版是单个 HTML 文件,4.8 MB,图片和附件全内嵌,双击就开,不联网也能看。左侧栏按篇、章、节三级跳转,滚动时自动高亮,手机上看也排得开。
PDF 是 A4,133 页。目录每一条都能点,页码是按实际分页回填的,不是手写的。书签分篇、章、节三级,打开文档就展开。页眉左边书名右边章名,页脚页码,打印出来是正常书的排版。
两个版本可以同时用。手机上翻网页版,打印或者发同事用 PDF。
