RevitPythonShell脚本无法识别已打开Revit项目的问题求助

核心问题定位 #

报错“No document is currently open or the document is disposed”的本质是脚本没法正确拿到当前活跃的Revit文档实例，在协同工作集模型里，这种情况大多和上下文获取逻辑、协同状态限制有关。

逐步排查修复步骤 #

1. 检查文档获取逻辑 #

• 必须用__revit__.ActiveUIDocument.Document获取当前文档，别用Application.Documents遍历取第一个——协同模型下这个方法可能拿到非活跃的文档对象，直接导致报错。
  正确的开头代码：

  import clr
  clr.AddReference('RevitAPI')
  clr.AddReference('RevitAPIUI')
  from Autodesk.Revit.DB import *
  from Autodesk.Revit.UI import *
  
  doc = __revit__.ActiveUIDocument.Document
  

• 测试脚本不能跳过这个核心逻辑，否则没法验证上下文是否正常。

2. 协同模型的特殊限制 #

• 协同模型里，脚本运行前得确保文档处于可交互状态：
  • 检查模型是不是在“工作集编辑”模式，别是只读或者被其他用户锁定了全局状态。
  • 脚本运行时别瞎操作Revit界面（比如切视图、点保存），不然会直接弄丢文档上下文。

3. RPS版本兼容性排查 #

• 2024版RPS可能和Revit 2024有上下文绑定的bug，试试：
  • 关掉RPS重新打开，再加载脚本运行。
  • 降级到RPS 2023.x版本测试，看是不是版本适配的问题。

4. 优化脚本性能避免上下文丢失 #

• 16000+元素的模型，要是一开始就全量遍历，容易让Revit临时释放文档上下文：
  • 用FilteredElementCollector结合工作集过滤器分批处理元素，别一次性加载所有内容，示例：

    # 按指定工作集过滤元素
    target_workset_id = WorksetId(2) # 换成你要处理的工作集ID
    collector = FilteredElementCollector(doc).WherePasses(WorksetFilter(target_workset_id))
    

  • 循环里别频繁调用doc.GetElement()，提前把需要的数据缓存好。

5. 对比参考脚本找差异 #

• 把当前脚本和之前能正常运行的参考脚本对比，重点看：
  • 是不是加了Transaction之外的文档修改操作？协同模型里所有修改都必须在Transaction块里执行。
  • 是不是误删了__revit__相关的上下文引用代码？

快速验证方法 #

先跑个最简测试脚本，确认文档获取是否正常：

import clr
clr.AddReference('RevitAPIUI')
from Autodesk.Revit.UI import TaskDialog

doc = __revit__.ActiveUIDocument.Document
TaskDialog.Show("测试", "当前文档名称：{}".format(doc.Title))

要是这个脚本还报错，那问题出在RPS或Revit的上下文绑定上，不是你业务脚本的逻辑问题。

内容的提问来源于stack exchange，提问作者Neil Wakeman