如何附加到Revit实例进程并测试Revit API？获取Document对象

云原生阿岚

2026-6-14

附加到已运行的Revit进程并获取Document对象

首先要明确：Revit API本身不支持跨进程直接访问，它是基于.NET的单进程API，所有操作必须在Revit进程内部执行。你无法直接从外部进程获取Revit的Document对象，必须通过在Revit进程内加载的插件来实现调试和交互。

以下是具体实现步骤：

1. 配置插件调试为“附加到进程”

打开你的C# Revit插件项目，右键项目→属性→调试选项卡
取消“启动外部程序”的路径设置，勾选“附加到进程”
先手动启动Revit并打开目标项目（只需一次，之后保持Revit处于打开状态）
在Visual Studio中点击调试按钮，选择正在运行的Revit进程完成附加

2. 通过Revit API获取当前活动Document

附加成功后，插件代码会在Revit进程内执行，直接调用Revit API即可获取Document对象：

using Autodesk.Revit.DB;
using Autodesk.Revit.UI;

public class MyTestCommand : IExternalCommand
{
    public Result Execute(ExternalCommandData commandData, ref string message, ElementSet elements)
    {
        // 获取当前活动的UIDocument和Document
        UIDocument uiDoc = commandData.Application.ActiveUIDocument;
        Document doc = uiDoc.Document;

        // 这里编写你的测试逻辑，例如输出文档信息
        TaskDialog.Show("调试信息", $"当前文档名称：{doc.Title}\n文档路径：{doc.PathName}");

        return Result.Succeeded;
    }
}