夜雨聆风■来源 | 多位BIM开发者实战整理
用AI写Revit插件，听起来很美好。实际上，AI生成的代码语法上可以完美，但在Revit这个特定环境里，有太多隐式规则——这些规则AI不仅不会提前告诉你，它自己根本不知道。
本文整理了多位BIM开发者在实战中踩过的28个典型坑，覆盖编译阻断、运行时崩溃、内存泄漏、逻辑隐蔽错误、渲染行为陷阱五个维度。这些坑，AI一个都不会提前告诉你。
版本碎片化——AI的"时空错乱"
这是用AI写Revit插件最常见、最致命的一类问题。AI的训练数据混用了不同版本的Revit API，给出的代码经常"时空错乱"——用Revit 2021的方法写给Revit 2019用的插件。
坑1：项目文件格式不兼容
AI默认使用SDK风格.csproj，但Revit 2020及更早版本只认传统XML格式的项目文件。编译通过、复制到Revit——加载报错，不识别。
坑2：跨版本API不存在
View.SetColorFillSchemeId() 是Revit 2020才引入的，AI可能为Revit 2019生成这段代码，编译直接报错。
坑3：族文档API限制
Revit 2020的FamilyItemManager没有NewTextNote方法。AI不知道这个版本限制，会反复生成"理论上正确"但跑不了的代码。
坑4：.NET Framework版本锁定
Revit版本与.NET Framework严格对应，AI默认用最新框架配置，导致编译环境不匹配。
核心教训：你必须精确知道自己用的是哪个Revit版本，以及这个版本的API到底支持什么。AI的最佳实践和Revit的现实之间，可能有五年的代差。
API调用与上下文——AI的"睁眼瞎"
AI生成的代码是"理想环境"下的逻辑。它无法感知当前Revit会话的真实状态——活动视图是什么、有没有选中元素、当前族类型是否为空。缺失这些检查，代码在真实环境里一跑就崩。
坑5：活动视图未判空。很多API（如PickObject）必须在有效视图下进行。AI代码常在未检查ActiveView是否为null的情况下直接调用。
坑6：PlanCircuit无构造方法。AI经常捏造 new PlanCircuit()，实际必须从 PlanTopology 对象获取。
坑7：Binding.Categories类型缺失。Categories是InstanceBinding派生类的属性，AI不会写类型转换：binding is InstanceBinding instanceBinding。
坑8：单位系统完全无知。AI默认按英尺计算，从不主动处理毫米/英尺的转换。
坑9：冷僻API自行编造。对训练数据不足的API，AI会"创作"不存在的调用方式，给你一段看着合理但完全不能用的代码。
事务与资源管理——插件越跑越慢的元凶
AI很少关心对象的释放。这类问题不会立刻暴露，但插件运行一段时间后变慢、崩溃，十有八九是这里埋的雷。
坑10：Transaction未包裹在using块中
这是最致命的错误。AI写的Transaction代码中若缺少using语句块，直接判为不合格。
坑11：几何对象未释放
get_Geometry()返回的GeometryElement等对象需手动Dispose()，AI从不主动写。
坑12：FilteredElementCollector未回收
大量采集后不释放，内存占用持续升高，直到Revit假死。
渲染与行为陷阱——无异常但结果全错
这类坑最隐蔽：代码编译通过、运行不报错，但结果完全不对。不是API问题，是Revit渲染层面的行为特性，搜遍StackOverflow都不一定能找到答案。
坑13：TextNote偏移=0时文字消失。逻辑上偏移0=正好在管道位置，但Revit渲染时文字和构件重叠被"吃掉"，完全不可见。解决方案简单到荒谬：偏移量统一+400mm。
坑14：坐标空间转换错误。项目坐标、视图坐标、族坐标是不同空间，AI从不主动处理转换。
坑15：浮点比较失败。精度问题导致元素查找和匹配的相等判断失败，实际调试极难定位。
逻辑隐蔽错误——语法完美但南辕北辙
除了上面四大类，还有一些更细碎但同样致命的问题：
坑16：逻辑完全相反 —— 代码语法编译通过，但实现了和需求相反的功能，且不报任何异常。
坑17：条件编译写错 —— 多版本支持的#if条件遗漏或写错，特定版本分支永远不进。
坑18：拼写与大小写 —— 长API名称如FilteredElementCollector经常拼错，编译时报错但容易排除。
坑19：多版本兼容缺失 —— AI默认只考虑当前版本，从不主动设计兼容策略。
坑20：前置条件全跳过 —— FamilyManager.CurrentType为null、Document未初始化等检查一概缺失。
回到那个最核心的问题：用AI写Revit插件到底行不行？
行。但前提是你自己得懂。
你必须知道自己的Revit版本有哪些API限制。你必须做好"AI生成了但跑不了"的心理准备。你必须能在踩坑之后快速定位——是API限制还是代码问题。
AI最大的价值不是替你写代码，是替你加速"试错-修正"循环。
同样一个功能，手写要一天，AI十分钟生成三版。前两版跑不了，第三版改一改能用了。你的价值在于判断哪一版方向是对的，以及知道为什么前两版不行。
如果你是在设计院做BIM的工程师，不会写代码但有很深的Revit使用经验——你可能是最适合用AI做插件的人群。因为痛点在你脑子里，判断力在你经验里，AI只是把这两样东西变成代码的工具。
最后送三句话：
1 把需求想清楚再开口——模糊想法会让AI反复试探，浪费时间和算力。
2 拿到代码先在测试项目里跑——别直接在正式项目里加载第一次生成的插件。
3 每次踩坑都是经验——这些坑踩过一遍，下次AI生成的代码你能一眼看出哪里不对。
❖ END ❖
欢迎转发 | 让更多BIM人少走弯路
