本分步文章介绍如何使用 Microsoft Office 安装日志文件来排查 Office 安装问题。

有时，Office 安装程序会出现问题，并且可能不会收到错误消息。 即使收到错误消息，也可能需要使用安装日志文件作为确定问题的工具之一。

本文讨论了解释 Office 安装日志文件中信息的几种方法。 主题按要使用每种技术的顺序列出。 本文不介绍你可能会遇到的每种情况，但它讨论了几个示例，其中通过解释安装程序日志文件解决了安装程序问题。

Microsoft 知识库中许多与安装错误相关的文章还包括一些日志文件，这些部分可帮助你确认本文描述了你遇到的同一问题。

Office 安装程序会自动在 \Temp 文件夹中创建日志文件。 对于登录或激活问题，日志将存储在 %temp% 下。 对于安装或修补问题，它们使用系统帐户，因此你还需要从 %windir%\temp 收集日志。有关详细信息，请参阅如何启用Microsoft 365 企业应用版 ULS 日志记录。

日志文件名中的 #### 字符是以 0001 开头的数字。 每次运行安装程序时，它们都会递增一个。 因此，数字最高的日志文件是最近运行安装程序时的日志文件。

注意

可能只有 Microsoft Windows Installer 日志文件用于 Office 安装。 在这种情况下，Office 安装的 Windows 安装程序日志文件将任务 (0001) 追加到日志文件中，而非 Task (0002) 。

根据遇到的问题，可能需要查看 Office 安装的安装程序日志文件或 Windows 安装程序日志文件。

Setup.exe文件的日志文件非常短，因为Setup.exe执行的任务数仅限于以下任务：

读取Setup.ini文件。

分析必须传递给 Windows Installer 的属性和开关的命令行。 常见的错误是包含 Transform=\.mst 在命令行上。 在命令行上使用此操作不会在安装过程中生成错误消息，但转换不会应用于安装。 正确的命令行是 Transforms=\.mst。

Setup.exe日志文件包含为安装指定的命令行，因此必须检查日志文件是否存在拼写错误，如上一示例中所示 (第一个命令行的转换末尾缺少字母) 。

验证是否正在使用正确的操作系统和服务包。

检查Msi.dll文件的版本。

启动 Instmsi (w) .exe 文件以安装 Windows Installer。

检查已安装的 Office beta 版本。

检查 Tahoma 和 TahomaBD 字体的版本。

默认情况下，安装程序会在 Office 中创建本地安装源，但仅当从 CD 或压缩的 CD 映像安装 Office 时。 如果本地计算机上存在足够的硬盘空间，安装程序默认会缓存整个安装源。 Windows 安装程序使用此本地安装源来安装 Office，并且本地源仍可用于稍后修复、重新安装或更新 Office。 用户可以按需安装功能或在维护模式下运行安装程序以添加新功能。 由于安装程序默认创建本地安装源，因此无需设置任何其他选项。 安装程序在用户计算机上的以下隐藏文件夹中创建本地安装源：

\Msocache\Downloadcode

默认情况下，安装程序会在 Office 中缓存整个源。 如果用户的计算机没有足够的磁盘空间，安装程序将仅缓存所选功能的安装文件。 安装程序在安装完成后保留本地安装源。

安装程序日志中可能包含以下信息：

要复制到 \MSOCACHE 文件夹的文件列表：要下载的文件：

确认本地安装源设置：

确认已完成的任务：

如果怀疑使用的命令行属性和交换机出现问题，则安装程序日志文件中也列出了这些项。 例如，如果使用以下命令行运行安装程序：

安装程序日志中包含以下文本：

注意

Setup.exe实际上不使用这些命令行开关和属性。 只需将它们传递到 Windows 安装程序) (Msiexec.exe文件。

如果Setup.exe的日志文件以类似于以下 (返回代码的文本结尾：1603) ，则安装的 Windows Installer 部分存在问题：

在这种情况下，必须查看 Office 安装的 Windows 安装程序日志文件。

Windows Installer 日志文件明显大于安装程序日志文件，最初可能看起来不可读。 但是，以下准则可以帮助你缩小问题范围：

如果在安装过程中收到一个错误消息，可在日志文件中搜索错误编号。 例如，如果在安装过程中收到“错误 1327”，请在日志中搜索“1327”。 你可能会发现类似于以下示例的文本：

这些日志条目中的关键文本为 “驱动器无效”。 在这种情况下，问题在于你使用了磁盘管理员等实用工具来更改安装 Windows 的位置的驱动器号。 虽然驱动器号已更改，但某些注册表项仍引用原始驱动器号。

如果 Microsoft 知识库没有与特定错误消息匹配的文章，请按照以下步骤诊断问题：

搜索日志文件中的错误编号。

从行中读取每一行，并显示错误编号。 通常您会看到表示失败的行，该行的最终结果是安装错误。

例如，已搜索日志文件以查找“错误 2737”。 以下文本位于 2737 错误的行或上方：

查看此文本时，可以看到在调用 CheckCAServer 时安装失败。

所有日志文件都包含一个或多个通常可以忽略的错误。 以下错误可能出现在任何日志文件中，并且通常不会指示安装问题：

要搜索的一件事是字符串“注意”。 在安装失败并出现 2755 错误的情况下，该案例的实际解决方法派生自错误上方的“注意”几行：

在此示例中，以下两行指示 \Winnt\Installer 文件夹的权限出现问题：

MSI (s) (EC：BC) ： 注意： 1： 2336 2： 5 3： C：\WINNT\Installer\ MSI (的) (EC：BC) ：MainEngineThread 返回 1632

在此文件夹上更正权限后，不会发生 2755 错误。

注意

包含“1632”的行是此问题处理权限的决定因素。

在包含 Note 的日志条目中， 注释 后面的四位数可以直接映射到本文前面引用的知识库文章中列出的 Windows 安装程序错误。

要在日志文件中搜索的另一个字符串是 返回值 3。 如果没有或记下错误编号，但在日志文件中找到 “返回值 3 ”，则需要重点进行故障排除。 在安装过程中执行操作时，会在日志文件中记录该操作。 该操作完成后，会记下返回值。 如果返回值为 1，则操作成功。 如果操作失败，则返回值为 3。

在这种情况下，SetW2kMill_WFP操作会成功，因为返回值为 1。 但是，下一个操作 CheckCAServer 失败，因为它的返回值为 3。

有时在查看日志文件时，找不到“注意”、“返回值 3”或错误编号。 相反，你可能会看到类似于以下示例的文本：

在这种情况下，安装程序在应用转换时遇到问题，因为转换不能位于指定路径 (C：\test.mst) 。 因此，安装程序还会尝试在 Office 源位置的根目录上查找转换。 当转换不能位于任一位置时，安装将停止。

Windows Installer 日志文件部分中列出的所有技术都可用于详细日志文件。 但是，详细日志记录会增加安装时间。 仅当遇到无法诊断为默认日志文件的安装问题时，才使用详细日志记录。

生成详细日志文件

在 Office 的初始安装中，不使用详细日志记录。 如果安装失败，则第二次尝试安装将生成详细日志文件。 但是，用于这些详细日志文件的日志记录选项并不是 Windows 安装程序可用的所有选项。 若要使用所有日志记录选项创建更详细的 Windows Installer 日志文件，可以使用 /L 开关的 *v 参数组合。

注意

使用类似于以下内容的命令行执行 Office 管理安装时，可以创建详细日志文件：

\setup.exe /a \Pro11.msi /L*v C:\Verboselog.txt

诊断设置何时停止响应

有时，Office 安装程序会停止响应 (挂起) ，并且不会收到任何错误消息。 在这种情况下，最好的办法是重新启动计算机，然后再次运行 Office 安装程序，并在 (上启用完整的详细日志记录，并) 一个附加选项。 为此，请执行以下步骤：

单击“开始”，然后单击“运行”。

在 “打开 ”框中，键入以下命令行，然后单击 “确定”：

\Setup.exe /L*v! C:\Verboselog.txt

此 是 Office 源位置的完整路径。

通常，在写入详细日志文件之前，内存中缓存 19 行日志记录信息。 如果不使用！ /L (日志记录) 开关的选项，如果安装停止，可能会丢失一些缓存信息或所有缓存信息。 如果使用！ 选项，你失去最多的是一行，因为！ 选项强制安装程序一次一行地将日志记录信息写入日志文件， (未缓存信息) 。

创建详细日志文件后，滚动到末尾并查看最后一行或两行。 这些行告诉你安装程序在停止时尝试执行的操作。 例如，你可能会看到类似于以下示例的文本：

这表示组件 (71CE92CC2CB71D119A12000A9CE1A22A22A) 的 Windows 注册表) 中的注册 (出现问题，其关键路径为 OWCDCH11.CHM。

此特定问题的解决方法是在再次运行 Office 安装程序之前修复 Windows 注册表。

在另一种情况下，可能会看到类似于日志文件中的以下示例的文本：

这表示 Office 删除向导操作出现问题。 当 Office 安装程序在删除早期版本的 Microsoft Office 时出现问题时，可能会出现此问题。 尝试删除早期版本的 Office，然后再次运行 Office 2003 安装程序。

注意

Office 安装程序对自定义操作使用以下前缀。 如果日志文件指示自定义操作出现问题，则这些前缀指示在何处开始故障排除。