简介面向Revit二次开发工程师的示例工程围绕DWGExportOptions类演示了在外部应用中自定义DWG导出参数、并批量出图的完整流程。资源将C#源码、界面资源和Addin配置文件整合为一套可加载的外部应用适合需要掌握Revit API、处理模型导出任务的中高级开发者参考。压缩包共包含81个文件以45个.cs源码文件为主辅以resx/resources界面资源、dll引用、sln/csproj工程文件及addin加载清单等整体大小仅279KB目录结构清晰目前已有921人学习下载。通过研读代码可以了解到DWGExportOptions中图层过滤、单位转换、图形质量等核心选项的调用方式以及外部应用如何挂载到Revit主程序并触发导出命令。工程中还包含ReadMe说明文档和界面布局文件能帮助理解从参数设置到输出成图的完整链路可直接基于此扩展批量导出PDF、DWG等定制工具。1. 为什么外部应用导出图纸值得重新做一遍用 Revit 自带功能导出 DWG 已经足够日常工作但当你面对一套项目图纸需要按公司图层标准、固定命名、指定版本一次导出时手动操作会让人怀疑人生。点开“导出”对话框选视图、选图层映射文件、核对单位、再逐个调整几十张图下来花费的时间比建模还多。更麻烦的是这种流程无法在其他项目里复用每次都在重复同一套点击。于是有了用 Revit 外部应用把“导出图纸”做成一个按键动作的想法通过 DWGExportOptions 控制图层映射、单位、版本和视图范围再用 IExternalApplication 把命令挂到 Ribbon 上让导图变成一次单击。这正好对应了归档文件名里“DWGExportOptions_REVIT 外部应用”的含义。本文适合正在做 Revit 二次开发的工程师或者被出图重复劳动折磨的 BIM 负责人。2. DWGExportOptions 参数设置把默认导出对话框变成可控代码2.1 先理解 DWGExportOptions 在 Revit API 中的位置在 Revit 二次开发中导出 DWG 的核心入口是Document.Export而DWGExportOptions是这个入口的参数容器。它决定了输出文件的图层结构、线型、单位、文件版本以及哪些视图被导出。如果你不设置任何属性Revit 会按默认配置走结果往往和你手工操作不一致例如图层名变成英文、单位变成英尺、版本不是目标软件需要的格式。所以用代码导出图纸的第一步不是写遍历逻辑而是理解这个选项类常用属性之间的依赖关系。下面是 Revit 2020 及以上版本中比较常见的属性列表建议你在开发时对照 API 文档核一下自己的 Revit 版本因为个别属性在不同版本中有调整属性名作用典型设置值DWGVersion输出的 DWG 文件格式版本DWGVersion.ACAD2018ExportLayerTable自定义图层映射表替代默认图层new ExportLayerTable(?)LayerMappingFile指定图层映射文件路径.txt 或 .xmlC:\Mapping\OurStandard.txtViews要导出的视图集合ListViewTargetUnit输出单位ExportUnit.MillimeterSharedCoords是否包含共享坐标true或falseHideScopeBoxes导出时是否隐藏范围框trueMergeViews多个视图是否合并到一个 DWG 文件true或falsePreviewForView是否生成预览true注意LayerMappingFile和ExportLayerTable二选一。如果你公司有自己维护的图层标准推荐用LayerMappingFile这样修改标准时只需要替换文件不需要重新编译插件。如果你希望图层的英文名和 Revit 类名完全一致可以不设置映射但那样导出的图在专业软件里打开后图层名会是最原始的英文类型名。2.2 创建一个可复用的 DWGExportOptions 配置代码块对于大多数项目我一般用一个静态方法集中创建选项这样所有导出入口共用一套配置不会出现一个地方改了参数另一个地方漏改的情况。下面这段代码可以直接放到你的工具类里using Autodesk.Revit.DB; using System.Collections.Generic; public static class DwgExportHelper { public static DWGExportOptions CreateStandardOptions( ListView views, string layerMappingFile ) { // 使用默认构造函数 DWGExportOptions options new DWGExportOptions(); // 设置输出版本根据合作方需求调整 options.DWGVersion DWGVersion.ACAD2018; // 单位设置为毫米适合中国区项目 options.TargetUnit ExportUnit.Millimeter; // 指定视图一次导出多张图时这里非常关键 options.Views views; // 隐藏范围框避免导出后出现多余线框 options.HideScopeBoxes true; // 共享坐标保持模型位置 options.SharedCoords true; // 层映射文件优先其次是默认图层 if (!string.IsNullOrEmpty(layerMappingFile)) { options.LayerMappingFile layerMappingFile; } return options; } }这段代码的逻辑很直白用默认构造器创建选项类然后给几个最重要的属性赋值。Views属性决定了导哪个视图这在批量导出时是核心。很多人只设置TargetUnit和DWGVersion却忘了Views结果一执行Export就报“当前视图不可导出”的错。另外HideScopeBoxes建议默认开启否则一旦模型里有范围框导出 DWG 会把范围框的轮廓线一起带出来后期清理很麻烦。SharedCoords建议保持true这样导出文件不会丢失项目基点信息不同专业文件对坐标时才不会错位。这里有一个关键陷阱DWGExportOptions.Views接收的是ListView但Document.Export的重载方法是接收IListElementId或者ViewSet因此你需要在真正导出时把视图集合传递给选项还是传递给导出方法需要看版本。在 Revit 2021 以上官方推荐的用法是直接给DWGExportOptions.Views赋值然后调用document.Export(path, options)。旧版本则常使用ViewSet作为Export的重载参数。建议封装一层内部判断 Revit 版本决定使用哪种方式。3. 外部应用 IExternalApplication 挂接导出命令的最简实现3.1 externality 怎么区分外部应用和外部命令在 Revit 二次开发中外部应用IExternalApplication和外部命令IExternalCommand是两回事。外部命令就是用户点某个按钮后执行的一段代码通常是一次性的动作外部应用则是随 Revit 启动而运行的程序宿主它负责创建 Ribbon 界面、注册事件并把界面按钮绑定到外部命令上。我们要做的“一键导出图纸”功能最少需要一个 IExternalApplication 来注册按钮一个 IExternalCommand 来执行真正的导出逻辑。很多初学者会把所有逻辑都塞进 IExternalCommand结果每次点按钮都要重新初始化配置也没有办法在启动时就验证图层映射文件是否存在。常见做法是用 IExternalApplication 的OnStartup方法读取配置文件把路径缓存到一个静态类中然后拿到模块里的按钮事件点击时才构造选项。这样既保证了启动时的一次性检查又不会让启动过程变慢。3.2 写一个最小可用的 Ribbon 按钮挂接代码下面是最小实现一个 RibbonTab一个 Panel一个 PushButton。假定你已经在 Visual Studio 中引用了 RevitAPI.dll 和 RevitAPIUI.dll。using Autodesk.Revit.UI; using Autodesk.Revit.DB; using System.Reflection; using System.IO; namespace RevitDwgExport { // 外部应用类由 Revit 自动加载 public class App : IExternalApplication { public Result OnStartup(UIControlledApplication application) { // 创建 Ribbon 页 application.CreateRibbonTab(出图工具); RibbonPanel panel application.CreateRibbonPanel(出图工具, DWG 导出); // 创建按钮绑定到外部命令类 PushButtonData buttonData new PushButtonData( ExportDwgButton, 导出当前图纸, Assembly.GetExecutingAssembly().Location, RevitDwgExport.ExportDwgCommand); PushButton pushButton panel.AddItem(buttonData) as PushButton; return Result.Succeeded; } public Result OnShutdown(UIControlledApplication application) { return Result.Succeeded; } } }这段代码中CreateRibbonTab先在 Ribbon 上建了一个页CreateRibbonPanel建了面板PushButtonData中的四个参数分别是命令类在程序集中的标识符、按钮名称、程序集路径和命名空间。注意Assembly.GetExecutingAssembly().Location会自动定位插件 DLL 位置不需要写死路径便于在不同电脑上部署。按钮文字“导出当前图纸”可以直接在界面上看到。外部命令类必须实现IExternalCommand最简单版本如下using Autodesk.Revit.DB; using Autodesk.Revit.UI; namespace RevitDwgExport { public class ExportDwgCommand : IExternalCommand { public Result Execute( ExternalCommandData commandData, ref string message, ElementSet elements) { Document doc commandData.Application.ActiveUIDocument.Document; // 这里会调用第 2 节创建的配置方法并执行导出 return DwgExporter.ExportCurrentView(doc); } } }这里commandData.Application.ActiveUIDocument.Document获取当前打开的文档。很多人在外部命令里写commandData.Application.Document那是错误的因为 API 没有这个属性。要养成从 ActiveUIDocument 取文档的习惯因为 Revit 支持多个文档同时打开必须明确是哪个文档。要让你写的IExternalApplication和IExternalCommand被 Revit 加载还需要一个.addin文件放入%AppData%\Autodesk\Revit\Addins\版本目录。常见格式是?xml version1.0 encodingutf-8? AddIn TypeApplication NameRevitDwgExport/Name AssemblyD:\Release\RevitDwgExport.dll/Assembly FullClassNameRevitDwgExport.App/FullClassName AddInIda1b2c3d4-eeee-ffff-0000-1234567890ab/AddInId VendorIdYourCompany/VendorId /AddIn这里面最坑的是AddInId必须是一个合法的 GUID否则 Revit 拒绝加载。可以自己在代码中生成一个 GUID然后粘贴到这里。另外注意.addin文件编码要用 UTF-8否则中文路径可能变成乱码。加载后重启 Revit你应该能在 Ribbon 上看到“出图工具”页。如果看不到检查.addin文件路径是否正确或者通过“设置面板”类的插件管理器查看是否加载失败。多数失败原因是 DLL 版本和 Revit 版本不匹配例如用 Revit 2022 API 编译却往 Revit 2020 里放。4. 实战批量导出图纸集中的所有图纸到 DWG4.1 明确批量导出的需求边界日常出图往往不是导出单一视图而是把当前项目的所有图纸一次性导出到文件夹里。所谓“图纸”在 Revit 中对应ViewSheet类也就是你图纸列表里那一张张带图框、有视图的图。如果只是把每个平面视图拿出来导出得到的文件里没有图框也没有项目名称和出图比例和专业方对接会非常麻烦。所以批量导出之前先要决定是从ViewSheet收集还是从ViewPlan收集。我的做法是优先处理ViewSheet因为那就是最终提交版的图纸内容。如果项目里既有施工图又有详图需要按视图类型过滤。比如只导出建筑面积大于某个范围的图纸或者只导出名称包含“建施”的图这类条件都可以通过FilteredElementCollector配合 LINQ 写成一行。4.2 收集所有图纸并批量导出下面是一个完整的批量导出方法放在外部命令的Execute中。它遍历当前文件的ViewSheet为每张图纸生成独立 DWG 文件文件名采用“图纸编号-图纸名称”的格式。using Autodesk.Revit.DB; using Autodesk.Revit.UI; using System.Collections.Generic; using System.IO; using System.Linq; public class BatchExportDwg { public static Result ExportAllSheets(Document doc, string baseDir) { // 收集所有还没有导出过的视图图纸 FilteredElementCollector collector new FilteredElementCollector(doc); ICollectionElement sheets collector .OfClass(typeof(ViewSheet)) .CastElement() .ToList(); int exportedCount 0; foreach (ViewSheet sheet in sheets) { // 每张图纸单独导出到文件 ListView viewList new ListView { sheet as View }; DWGExportOptions options DwgExportHelper.CreateStandardOptions(viewList); string filename string.Format({0}-{1}.dwg, sheet.SheetNumber, sheet.Name); string fullPath Path.Combine(baseDir, SanitizeFileName(filename)); if (doc.Export(fullPath, options) true) { exportedCount; } else { // 打印失败原因便于排查 TaskDialog.Show(导出提示, 图纸 sheet.SheetNumber 导出失败); } } TaskDialog.Show(导出完成, 成功导出 exportedCount 张图纸); return exportedCount sheets.Count ? Result.Succeeded : Result.Failed; } static string SanitizeFileName(string name) { foreach (char c in Path.GetInvalidFileNameChars()) { name name.Replace(c, _); } return name; } }逻辑说明OfClass(typeof(ViewSheet))只取图纸类元素避免把平面视图、剖面视图也带进来。doc.Export(fullPath, options)是 Revit API 中重载后的导出方法它会根据 options.Views 中提供的视图列表生成 dwg。这里为了保留图纸编号用sheet.SheetNumber和sheet.Name拼接文件名。SanitizeFileName用来替换 Windows 文件名中的非法字符比如/和:。参数说明很重要sheet.SheetNumber是“建施-01”这样的编号不一定兼容文件名所以必须先做清理。baseDir目录如果不存在Path.Combine不会自动创建你需要在调用前加一行Directory.CreateDirectory(baseDir)。此外如果合作方要求所有图纸合并到一个 DWG 文件不要用上述循环而是把多张 ViewSheet 放在同一个ListView里设置options.MergeViews true然后只调用一次doc.Export。执行这个命令前确认你已经把第 2 节中的DwgExportHelper和本节的方法放进同一个命令类。最终用户点击 Ribbon 按钮后会弹出版本选择提示还是直接导出到默认目录需要在 UI 上做一点引导。最简单的是在Execute方法里弹TaskDialog询问用户“是否导出当前项目所有图纸”确定后执行。这比一股脑导出安全因为一张错误参数设置可能导致整个项目文件卡死。4.3 批量导出时经常被忽略的打印设置问题往往不出在导出方法上而是出在视图的Scale和Detail Level。Revit 导出 DWG 时一个视图如果没有有效比例比如 3D 视图导出会失败或者输出文件里没有图形。对于ViewSheet每张图纸本身有自己的真实尺度所以基本没问题。但如果你把平面视图加进去就要保证这些视图的Scale大于 0。可以在导出前强制检查// 对于非图纸类视图要求 Scale 0 ViewPlan plan view as ViewPlan; if (plan ! null plan.Scale 0) { continue; }另外Revit 中“绘图视图”和“详图索引”虽然也是视图但它们的比例往往继承自源视图直接导出时可能丢失图框。所以我在实际项目中只导出ViewSheet。这算是我个人的一条铁律批量导图永远从图纸集出发不要尝试单独拼接平面图。这样能绕开很多显示问题合作方拿到的也是完整图框不会因为一两个视图没调整比例而返工。5. 验证导出结果与绕开三个高频坑5.1 用文件级检查确认导出是否完整批量导出结束后除了 Revit 内部打印成功数量我还会额外跑一段脚本去核对文件数量和非零大小。比如用 PowerShell 检查目标目录中 DWG 文件数量是否和图纸数量一致并查看是否有 0 字节文件。这个步骤看起来多余但能第一时间发现“某些图纸由于导出失败被跳过了但未提示”的隐患。Revit 的Export方法在异常情况下会返回 false但如果你没有在循环里处理返回值用户可能以为成功了。更严谨的验证是在导出后打开 CAD使用AUDIT或EATTEXT检查图层。但那样手动工作量又上来了。折中的方案是在导出后读取每个 DWG 文件头看文件版本是否等于你设置的 ACAD2018。可以用 C# 写一个小工具读取文件头前六个字节判断版本字符串AC1027 表示 AutoCAD 2018。虽然不是百分百可靠但作为快速冒烟测试足够了。这里提供一个 PowerShell 片段$path D:\ExportedDwgs $count (Get-ChildItem -Path $path -Filter *.dwg).Count $empty (Get-ChildItem -Path $path -Filter *.dwg | Where-Object { $_.Length -eq 0 }).Count Write-Host 总共$count 个DWG0字节文件数$empty这个小脚本比 Revit 内的提示更有全局观。若计数不一致优先去查看是否存在图纸编号重复导致的文件覆盖或者是否因为导出中途 Revit 无响应而中断。5.2 三个高频坑及处理方案坑一图层映射文件路径失效。很多公司把图层映射文件放在网络驱动器上Revit 在后台进程导出时访问网络路径会有权限问题。解决方案外部应用启动时把映射文件复制到本地临时目录然后在创建DWGExportOptions时使用本地路径。这样也顺带提升了导出速度因为网络 I/O 通常会拖慢整个导出过程。坑二背面视图导不出。某些视图是在工程图纸中不可见的例如“视图副本”。ViewSheet导出的视图本身没问题但如果你手动往选项里塞了一个不可视图纸就会报错。建议统一用FilteredElementCollector过滤不要自己 new 出视图集合或手工选择。坑三多个视图合并后图层冲突。当设置MergeViews true且一次导出多个视图时不同视图的同名图层会被合并导致几何体重叠或者图元被自动隐藏。如果碰到这种情况检查是不是某两张图纸包含同一个元素例如项目基线和立面标记在两处重复出现。通常合并导出只适合“一层平面图包含 1-0 到 1-5 ”这种连续但没有重叠的视图。如果合并后出现怪问题还是恢复成一张一张导出。从长远看更好的做法是给导出命令增加一个“导出集”的概念把当前视图、所有图纸、指定图纸集做成三种预设。以后每次出图时按场景选择即可。用外部应用承载好这个逻辑你就不需要再打开“导出 DWG”对话框了。最后一个小技巧把导出目录的路径写进配置文件而不是写死在代码里。这样不同项目只需要改一个config.ini不需要重新编译插件。你可以在IExternalApplication.OnStartup中读取配置存到静态变量里让DWGExportOptions的构造继续复用。这一步做完你的 Revit 出图工具才算真正脱离手工操作变成可以交出去给项目直接用的稳定功能。本文还有配套的精品资源点击获取
简介面向Revit二次开发工程师的示例工程围绕DWGExportOptions类演示了在外部应用中自定义DWG导出参数、并批量出图的完整流程。资源将C#源码、界面资源和Addin配置文件整合为一套可加载的外部应用适合需要掌握Revit API、处理模型导出任务的中高级开发者参考。压缩包共包含81个文件以45个.cs源码文件为主辅以resx/resources界面资源、dll引用、sln/csproj工程文件及addin加载清单等整体大小仅279KB目录结构清晰目前已有921人学习下载。通过研读代码可以了解到DWGExportOptions中图层过滤、单位转换、图形质量等核心选项的调用方式以及外部应用如何挂载到Revit主程序并触发导出命令。工程中还包含ReadMe说明文档和界面布局文件能帮助理解从参数设置到输出成图的完整链路可直接基于此扩展批量导出PDF、DWG等定制工具。1. 为什么外部应用导出图纸值得重新做一遍用 Revit 自带功能导出 DWG 已经足够日常工作但当你面对一套项目图纸需要按公司图层标准、固定命名、指定版本一次导出时手动操作会让人怀疑人生。点开“导出”对话框选视图、选图层映射文件、核对单位、再逐个调整几十张图下来花费的时间比建模还多。更麻烦的是这种流程无法在其他项目里复用每次都在重复同一套点击。于是有了用 Revit 外部应用把“导出图纸”做成一个按键动作的想法通过 DWGExportOptions 控制图层映射、单位、版本和视图范围再用 IExternalApplication 把命令挂到 Ribbon 上让导图变成一次单击。这正好对应了归档文件名里“DWGExportOptions_REVIT 外部应用”的含义。本文适合正在做 Revit 二次开发的工程师或者被出图重复劳动折磨的 BIM 负责人。2. DWGExportOptions 参数设置把默认导出对话框变成可控代码2.1 先理解 DWGExportOptions 在 Revit API 中的位置在 Revit 二次开发中导出 DWG 的核心入口是Document.Export而DWGExportOptions是这个入口的参数容器。它决定了输出文件的图层结构、线型、单位、文件版本以及哪些视图被导出。如果你不设置任何属性Revit 会按默认配置走结果往往和你手工操作不一致例如图层名变成英文、单位变成英尺、版本不是目标软件需要的格式。所以用代码导出图纸的第一步不是写遍历逻辑而是理解这个选项类常用属性之间的依赖关系。下面是 Revit 2020 及以上版本中比较常见的属性列表建议你在开发时对照 API 文档核一下自己的 Revit 版本因为个别属性在不同版本中有调整属性名作用典型设置值DWGVersion输出的 DWG 文件格式版本DWGVersion.ACAD2018ExportLayerTable自定义图层映射表替代默认图层new ExportLayerTable(?)LayerMappingFile指定图层映射文件路径.txt 或 .xmlC:\Mapping\OurStandard.txtViews要导出的视图集合ListViewTargetUnit输出单位ExportUnit.MillimeterSharedCoords是否包含共享坐标true或falseHideScopeBoxes导出时是否隐藏范围框trueMergeViews多个视图是否合并到一个 DWG 文件true或falsePreviewForView是否生成预览true注意LayerMappingFile和ExportLayerTable二选一。如果你公司有自己维护的图层标准推荐用LayerMappingFile这样修改标准时只需要替换文件不需要重新编译插件。如果你希望图层的英文名和 Revit 类名完全一致可以不设置映射但那样导出的图在专业软件里打开后图层名会是最原始的英文类型名。2.2 创建一个可复用的 DWGExportOptions 配置代码块对于大多数项目我一般用一个静态方法集中创建选项这样所有导出入口共用一套配置不会出现一个地方改了参数另一个地方漏改的情况。下面这段代码可以直接放到你的工具类里using Autodesk.Revit.DB; using System.Collections.Generic; public static class DwgExportHelper { public static DWGExportOptions CreateStandardOptions( ListView views, string layerMappingFile ) { // 使用默认构造函数 DWGExportOptions options new DWGExportOptions(); // 设置输出版本根据合作方需求调整 options.DWGVersion DWGVersion.ACAD2018; // 单位设置为毫米适合中国区项目 options.TargetUnit ExportUnit.Millimeter; // 指定视图一次导出多张图时这里非常关键 options.Views views; // 隐藏范围框避免导出后出现多余线框 options.HideScopeBoxes true; // 共享坐标保持模型位置 options.SharedCoords true; // 层映射文件优先其次是默认图层 if (!string.IsNullOrEmpty(layerMappingFile)) { options.LayerMappingFile layerMappingFile; } return options; } }这段代码的逻辑很直白用默认构造器创建选项类然后给几个最重要的属性赋值。Views属性决定了导哪个视图这在批量导出时是核心。很多人只设置TargetUnit和DWGVersion却忘了Views结果一执行Export就报“当前视图不可导出”的错。另外HideScopeBoxes建议默认开启否则一旦模型里有范围框导出 DWG 会把范围框的轮廓线一起带出来后期清理很麻烦。SharedCoords建议保持true这样导出文件不会丢失项目基点信息不同专业文件对坐标时才不会错位。这里有一个关键陷阱DWGExportOptions.Views接收的是ListView但Document.Export的重载方法是接收IListElementId或者ViewSet因此你需要在真正导出时把视图集合传递给选项还是传递给导出方法需要看版本。在 Revit 2021 以上官方推荐的用法是直接给DWGExportOptions.Views赋值然后调用document.Export(path, options)。旧版本则常使用ViewSet作为Export的重载参数。建议封装一层内部判断 Revit 版本决定使用哪种方式。3. 外部应用 IExternalApplication 挂接导出命令的最简实现3.1 externality 怎么区分外部应用和外部命令在 Revit 二次开发中外部应用IExternalApplication和外部命令IExternalCommand是两回事。外部命令就是用户点某个按钮后执行的一段代码通常是一次性的动作外部应用则是随 Revit 启动而运行的程序宿主它负责创建 Ribbon 界面、注册事件并把界面按钮绑定到外部命令上。我们要做的“一键导出图纸”功能最少需要一个 IExternalApplication 来注册按钮一个 IExternalCommand 来执行真正的导出逻辑。很多初学者会把所有逻辑都塞进 IExternalCommand结果每次点按钮都要重新初始化配置也没有办法在启动时就验证图层映射文件是否存在。常见做法是用 IExternalApplication 的OnStartup方法读取配置文件把路径缓存到一个静态类中然后拿到模块里的按钮事件点击时才构造选项。这样既保证了启动时的一次性检查又不会让启动过程变慢。3.2 写一个最小可用的 Ribbon 按钮挂接代码下面是最小实现一个 RibbonTab一个 Panel一个 PushButton。假定你已经在 Visual Studio 中引用了 RevitAPI.dll 和 RevitAPIUI.dll。using Autodesk.Revit.UI; using Autodesk.Revit.DB; using System.Reflection; using System.IO; namespace RevitDwgExport { // 外部应用类由 Revit 自动加载 public class App : IExternalApplication { public Result OnStartup(UIControlledApplication application) { // 创建 Ribbon 页 application.CreateRibbonTab(出图工具); RibbonPanel panel application.CreateRibbonPanel(出图工具, DWG 导出); // 创建按钮绑定到外部命令类 PushButtonData buttonData new PushButtonData( ExportDwgButton, 导出当前图纸, Assembly.GetExecutingAssembly().Location, RevitDwgExport.ExportDwgCommand); PushButton pushButton panel.AddItem(buttonData) as PushButton; return Result.Succeeded; } public Result OnShutdown(UIControlledApplication application) { return Result.Succeeded; } } }这段代码中CreateRibbonTab先在 Ribbon 上建了一个页CreateRibbonPanel建了面板PushButtonData中的四个参数分别是命令类在程序集中的标识符、按钮名称、程序集路径和命名空间。注意Assembly.GetExecutingAssembly().Location会自动定位插件 DLL 位置不需要写死路径便于在不同电脑上部署。按钮文字“导出当前图纸”可以直接在界面上看到。外部命令类必须实现IExternalCommand最简单版本如下using Autodesk.Revit.DB; using Autodesk.Revit.UI; namespace RevitDwgExport { public class ExportDwgCommand : IExternalCommand { public Result Execute( ExternalCommandData commandData, ref string message, ElementSet elements) { Document doc commandData.Application.ActiveUIDocument.Document; // 这里会调用第 2 节创建的配置方法并执行导出 return DwgExporter.ExportCurrentView(doc); } } }这里commandData.Application.ActiveUIDocument.Document获取当前打开的文档。很多人在外部命令里写commandData.Application.Document那是错误的因为 API 没有这个属性。要养成从 ActiveUIDocument 取文档的习惯因为 Revit 支持多个文档同时打开必须明确是哪个文档。要让你写的IExternalApplication和IExternalCommand被 Revit 加载还需要一个.addin文件放入%AppData%\Autodesk\Revit\Addins\版本目录。常见格式是?xml version1.0 encodingutf-8? AddIn TypeApplication NameRevitDwgExport/Name AssemblyD:\Release\RevitDwgExport.dll/Assembly FullClassNameRevitDwgExport.App/FullClassName AddInIda1b2c3d4-eeee-ffff-0000-1234567890ab/AddInId VendorIdYourCompany/VendorId /AddIn这里面最坑的是AddInId必须是一个合法的 GUID否则 Revit 拒绝加载。可以自己在代码中生成一个 GUID然后粘贴到这里。另外注意.addin文件编码要用 UTF-8否则中文路径可能变成乱码。加载后重启 Revit你应该能在 Ribbon 上看到“出图工具”页。如果看不到检查.addin文件路径是否正确或者通过“设置面板”类的插件管理器查看是否加载失败。多数失败原因是 DLL 版本和 Revit 版本不匹配例如用 Revit 2022 API 编译却往 Revit 2020 里放。4. 实战批量导出图纸集中的所有图纸到 DWG4.1 明确批量导出的需求边界日常出图往往不是导出单一视图而是把当前项目的所有图纸一次性导出到文件夹里。所谓“图纸”在 Revit 中对应ViewSheet类也就是你图纸列表里那一张张带图框、有视图的图。如果只是把每个平面视图拿出来导出得到的文件里没有图框也没有项目名称和出图比例和专业方对接会非常麻烦。所以批量导出之前先要决定是从ViewSheet收集还是从ViewPlan收集。我的做法是优先处理ViewSheet因为那就是最终提交版的图纸内容。如果项目里既有施工图又有详图需要按视图类型过滤。比如只导出建筑面积大于某个范围的图纸或者只导出名称包含“建施”的图这类条件都可以通过FilteredElementCollector配合 LINQ 写成一行。4.2 收集所有图纸并批量导出下面是一个完整的批量导出方法放在外部命令的Execute中。它遍历当前文件的ViewSheet为每张图纸生成独立 DWG 文件文件名采用“图纸编号-图纸名称”的格式。using Autodesk.Revit.DB; using Autodesk.Revit.UI; using System.Collections.Generic; using System.IO; using System.Linq; public class BatchExportDwg { public static Result ExportAllSheets(Document doc, string baseDir) { // 收集所有还没有导出过的视图图纸 FilteredElementCollector collector new FilteredElementCollector(doc); ICollectionElement sheets collector .OfClass(typeof(ViewSheet)) .CastElement() .ToList(); int exportedCount 0; foreach (ViewSheet sheet in sheets) { // 每张图纸单独导出到文件 ListView viewList new ListView { sheet as View }; DWGExportOptions options DwgExportHelper.CreateStandardOptions(viewList); string filename string.Format({0}-{1}.dwg, sheet.SheetNumber, sheet.Name); string fullPath Path.Combine(baseDir, SanitizeFileName(filename)); if (doc.Export(fullPath, options) true) { exportedCount; } else { // 打印失败原因便于排查 TaskDialog.Show(导出提示, 图纸 sheet.SheetNumber 导出失败); } } TaskDialog.Show(导出完成, 成功导出 exportedCount 张图纸); return exportedCount sheets.Count ? Result.Succeeded : Result.Failed; } static string SanitizeFileName(string name) { foreach (char c in Path.GetInvalidFileNameChars()) { name name.Replace(c, _); } return name; } }逻辑说明OfClass(typeof(ViewSheet))只取图纸类元素避免把平面视图、剖面视图也带进来。doc.Export(fullPath, options)是 Revit API 中重载后的导出方法它会根据 options.Views 中提供的视图列表生成 dwg。这里为了保留图纸编号用sheet.SheetNumber和sheet.Name拼接文件名。SanitizeFileName用来替换 Windows 文件名中的非法字符比如/和:。参数说明很重要sheet.SheetNumber是“建施-01”这样的编号不一定兼容文件名所以必须先做清理。baseDir目录如果不存在Path.Combine不会自动创建你需要在调用前加一行Directory.CreateDirectory(baseDir)。此外如果合作方要求所有图纸合并到一个 DWG 文件不要用上述循环而是把多张 ViewSheet 放在同一个ListView里设置options.MergeViews true然后只调用一次doc.Export。执行这个命令前确认你已经把第 2 节中的DwgExportHelper和本节的方法放进同一个命令类。最终用户点击 Ribbon 按钮后会弹出版本选择提示还是直接导出到默认目录需要在 UI 上做一点引导。最简单的是在Execute方法里弹TaskDialog询问用户“是否导出当前项目所有图纸”确定后执行。这比一股脑导出安全因为一张错误参数设置可能导致整个项目文件卡死。4.3 批量导出时经常被忽略的打印设置问题往往不出在导出方法上而是出在视图的Scale和Detail Level。Revit 导出 DWG 时一个视图如果没有有效比例比如 3D 视图导出会失败或者输出文件里没有图形。对于ViewSheet每张图纸本身有自己的真实尺度所以基本没问题。但如果你把平面视图加进去就要保证这些视图的Scale大于 0。可以在导出前强制检查// 对于非图纸类视图要求 Scale 0 ViewPlan plan view as ViewPlan; if (plan ! null plan.Scale 0) { continue; }另外Revit 中“绘图视图”和“详图索引”虽然也是视图但它们的比例往往继承自源视图直接导出时可能丢失图框。所以我在实际项目中只导出ViewSheet。这算是我个人的一条铁律批量导图永远从图纸集出发不要尝试单独拼接平面图。这样能绕开很多显示问题合作方拿到的也是完整图框不会因为一两个视图没调整比例而返工。5. 验证导出结果与绕开三个高频坑5.1 用文件级检查确认导出是否完整批量导出结束后除了 Revit 内部打印成功数量我还会额外跑一段脚本去核对文件数量和非零大小。比如用 PowerShell 检查目标目录中 DWG 文件数量是否和图纸数量一致并查看是否有 0 字节文件。这个步骤看起来多余但能第一时间发现“某些图纸由于导出失败被跳过了但未提示”的隐患。Revit 的Export方法在异常情况下会返回 false但如果你没有在循环里处理返回值用户可能以为成功了。更严谨的验证是在导出后打开 CAD使用AUDIT或EATTEXT检查图层。但那样手动工作量又上来了。折中的方案是在导出后读取每个 DWG 文件头看文件版本是否等于你设置的 ACAD2018。可以用 C# 写一个小工具读取文件头前六个字节判断版本字符串AC1027 表示 AutoCAD 2018。虽然不是百分百可靠但作为快速冒烟测试足够了。这里提供一个 PowerShell 片段$path D:\ExportedDwgs $count (Get-ChildItem -Path $path -Filter *.dwg).Count $empty (Get-ChildItem -Path $path -Filter *.dwg | Where-Object { $_.Length -eq 0 }).Count Write-Host 总共$count 个DWG0字节文件数$empty这个小脚本比 Revit 内的提示更有全局观。若计数不一致优先去查看是否存在图纸编号重复导致的文件覆盖或者是否因为导出中途 Revit 无响应而中断。5.2 三个高频坑及处理方案坑一图层映射文件路径失效。很多公司把图层映射文件放在网络驱动器上Revit 在后台进程导出时访问网络路径会有权限问题。解决方案外部应用启动时把映射文件复制到本地临时目录然后在创建DWGExportOptions时使用本地路径。这样也顺带提升了导出速度因为网络 I/O 通常会拖慢整个导出过程。坑二背面视图导不出。某些视图是在工程图纸中不可见的例如“视图副本”。ViewSheet导出的视图本身没问题但如果你手动往选项里塞了一个不可视图纸就会报错。建议统一用FilteredElementCollector过滤不要自己 new 出视图集合或手工选择。坑三多个视图合并后图层冲突。当设置MergeViews true且一次导出多个视图时不同视图的同名图层会被合并导致几何体重叠或者图元被自动隐藏。如果碰到这种情况检查是不是某两张图纸包含同一个元素例如项目基线和立面标记在两处重复出现。通常合并导出只适合“一层平面图包含 1-0 到 1-5 ”这种连续但没有重叠的视图。如果合并后出现怪问题还是恢复成一张一张导出。从长远看更好的做法是给导出命令增加一个“导出集”的概念把当前视图、所有图纸、指定图纸集做成三种预设。以后每次出图时按场景选择即可。用外部应用承载好这个逻辑你就不需要再打开“导出 DWG”对话框了。最后一个小技巧把导出目录的路径写进配置文件而不是写死在代码里。这样不同项目只需要改一个config.ini不需要重新编译插件。你可以在IExternalApplication.OnStartup中读取配置存到静态变量里让DWGExportOptions的构造继续复用。这一步做完你的 Revit 出图工具才算真正脱离手工操作变成可以交出去给项目直接用的稳定功能。本文还有配套的精品资源点击获取
