通过Visual Studio启动的Outlook Web AddIn控件无法正常显示

我近期尝试为Microsoft Outlook开发新的Web加载项，此前没有相关经验。按照微软官方文档完成了一个简易加载项的开发，该加载项原本包含一个带有6个控件（按钮）的CustomTab。之前这个加载项能正常显示所有控件，但现在通过Visual Studio启动时，仅能看到主按钮NoRA，点击后无法展开控件列表。

加载项清单文件代码（Hosts部分） #

<Hosts>
    <Host xsi:type="MailHost">
        <DesktopFormFactor>
            <!-- Location of the Functions that UI-less buttons can trigger (ExecuteFunction Actions). -->
            <FunctionFile resid="functionFile" />
            <!-- Message Read -->
            <ExtensionPoint xsi:type="MessageReadCommandSurface">
                <!-- Use the default tab of the ExtensionPoint or create your own with <CustomTab id="myTab"> -->
                <CustomTab id="myTab">
                    <!-- Up to 6 Groups added per Tab -->
                    <Group id="NoraGroup">
                        <Label resid="NoraGroupLabel" />
                        <!-- Launch the add-in : task pane button -->
                        <Control xsi:type="Button" id="Button1">
                            <Action xsi:type="ShowTaskpane">
                                <SourceLocation resid="messageReadTaskPaneUrl" />
                            </Action>
                        </Control>

                        <Control xsi:type="Button" id="Button2">
                            <Action xsi:type="ExecuteFunction">
                                <FunctionName>saveEmail</FunctionName>
                            </Action>
                        </Control>

                        <Control xsi:type="Button" id="Button3">
                            <Action xsi:type="ExecuteFunction">
                                <FunctionName>saveEmailAndAttachment</FunctionName>
                            </Action>
                        </Control>
                        <!-- Go to http://aka.ms/ButtonCommands to learn how to add more Controls: ExecuteFunction and Menu -->
                    </Group>
                </CustomTab>
            </ExtensionPoint>
            <!-- Go to http://aka.ms/ExtensionPointsCommands to learn how to add more Extension Points: MessageRead, AppointmentOrganizer, AppointmentAttendee -->
        </DesktopFormFactor>
    </Host>
</Hosts>

相关截图 #

• 加载项正常状态：加载项正常显示所有控件
• 控制台调试界面：异常时的控制台截图

排查解决方向 #

1. 核对清单文件配置：你提供的清单代码里仅显示了3个Control，确认是否误删除了另外3个控件的配置代码，或者新增/修改的配置存在语法错误（比如标签未闭合、resid引用的资源不存在）。
2. 验证FunctionFile有效性：确认清单中functionFile对应的resid是否正确指向了包含saveEmail、saveEmailAndAttachment函数的脚本文件，文件路径在项目中是否正确，且脚本本身无语法错误。
3. 重置调试环境：清理Visual Studio项目的生成文件，重新生成解决方案；重启Visual Studio和Outlook客户端，确保调试服务器正常运行，没有端口占用或资源加载失败的情况。
4. 查看加载项诊断日志：在Outlook中打开加载项诊断工具，检查是否有清单验证失败、资源加载错误等具体报错信息，这能直接定位问题根源。
5. 检查控件数量与布局规则：Outlook加载项中每个Group最多允许6个控件，虽然你之前正常，但如果近期调整了控件布局或新增了元素，可能触发了UI渲染限制，需确认配置符合官方规范。

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