C#开发Navisworks插件时插件及自定义表单无法在软件中显示求助

1. 插件基础配置排查 #

• 检查插件清单文件（*.nwaddon）配置是否正确：
  • 确保文件放置在Navisworks识别的加载目录：默认路径为C:\Program Files\Autodesk\Navisworks Manage 版本号\Plugins，或者当前用户的%APPDATA%\Autodesk\Navisworks Manage 版本号\Plugins目录
  • 检查清单内的Assembly节点路径是否和你编译生成的dll实际路径一致，Name、Vendor、Version字段无非法字符
  • 确认AddIn节点的Type属性值是你插件入口类的完整命名空间+类名，没有拼写错误
• 检查.NET框架版本兼容性：项目使用的.NET框架版本必须和对应Navisworks版本支持的框架一致，比如Navisworks 2020及以后要求.NET Framework 4.7以上，低版本Navisworks不兼容高版本.NET框架，会直接静默不加载
• 检查平台架构：项目编译目标平台必须设置为x64，Navisworks是64位程序，无法加载32位程序集

2. 插件入口代码逻辑排查 #

• 入口类必须继承Autodesk.Navisworks.Api.Plugin接口，且正确实现Execute方法
• 检查入口类是否添加了[Plugin]特性，特性参数中的Id为唯一GUID，DisplayName、ToolTip字段配置正确
• 如果用Ribbon按钮触发表单，检查Ribbon面板、按钮的创建逻辑是否写在Execute方法内，或者正确注册到Navisworks的启动事件中，示例入口逻辑参考：

[Plugin(
    DisplayName = "Excel快捷工具",
    Id = "替换为你的唯一GUID",
    Vendor = "你的名称",
    ToolTip = "点击唤起Excel打开面板"
)]
public class ExcelPlugin : Autodesk.Navisworks.Api.Plugin
{
    public override int Execute(params string[] parameters)
    {
        // 实例化表单时必须指定Navisworks主窗口为父窗口，否则表单会被遮挡或无法渲染
        var form = new YourCustomForm();
        form.ShowDialog(Autodesk.Navisworks.Api.Application.Gui.MainWindow);
        return 0;
    }
}

• 特别注意：禁止在VS调试环境外直接调用form.Show()或者无参数的ShowDialog()，必须指定父窗口参数。

3. 表单相关依赖排查 #

• 检查表单用到的所有依赖库（比如Excel interop、第三方控件库等）是否和插件dll放在同一目录，或者已经注册到GAC，缺少依赖会直接导致加载失败
• 如果使用WinForm/WPF表单，确保项目引用中已经正确添加了System.Windows.Forms或者PresentationFramework相关程序集，且「复制本地」属性设置为True
• 排查权限问题：如果要打开的Excel文件放在系统受保护目录（比如C盘根目录、Program Files目录），Navisworks进程没有读写权限会导致表单触发操作无响应，可先将Excel文件放到桌面测试。

4. 调试验证步骤 #

• 打开Navisworks，点击顶部菜单工具 > 附加模块管理器，查看你的插件是否在列表中：如果不在说明是基础配置或编译问题，如果在但未勾选，手动勾选后重启Navisworks即可。
• 附加进程调试：打开VS，点击调试 > 附加到进程，选择正在运行的navisworks.exe进程，在插件入口的Execute方法和表单实例化代码处打断点，点击插件按钮看断点是否命中：如果未命中说明插件没有正常加载，如果命中但表单不显示，排查表单的Visible属性、父窗口设置是否正确。
• 查看Windows事件查看器：打开事件查看器 > Windows日志 > 应用程序，查找Navisworks相关的错误日志，会明确提示dll加载失败的具体原因，比如依赖缺失、权限不足、框架版本不兼容等。

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