密钥管理服务 (KMS) 客户端激活和产品密钥

若要使用 KMS，需要有一个在本地网络上可用的 KMS 主机。 使用 KMS 主机激活的计算机需要具有特定的产品密钥。 此密钥有时称为 KMS 客户端密钥，但其正式名称为 Microsoft 通用批量许可证密钥 (GVLK)。 默认情况下，运行 Windows Server 和 Windows 客户端批量许可版本的计算机是无需额外配置的 KMS 客户端，因为相关 GVLK 已经存在。

但是，在某些情况下，需要将 GVLK 添加到要针对 KMS 主机激活的计算机，例如：

• 转换计算机使其不使用多次激活密钥 (MAK)
• 将 Windows 的零售许可证转换为 KMS 客户端
• 如果计算机以前是 KMS 主机

重要

若要使用此处列出的密钥（它们是 GVLK），你必须首先在本地网络中拥有可用的 KMS 主机。 如果还没有 KMS 主机，请参阅如何创建 KMS 主机以了解详细信息。

如果希望在没有可用的 KMS 主机的情况下在批量激活方案之外激活 Windows（例如，尝试激活 Windows 客户端的零售版本），则这些密钥将不起作用。 需要使用另一种激活 Windows 的方法，如使用 MAK 或购买零售许可证。 获取帮助以查找 Windows 产品密钥并了解 Windows 的正版版本。

安装产品密钥

如果要将计算机从 KMS 主机、MAK 或零售版本 Windows 转换为 KMS 客户端，可以从本文中的列表安装适用的产品密钥 (GVLK)。 若要安装客户端产品密钥，请在客户端上打开一个管理命令提示符，并运行以下命令，然后按 Enter：

Windows 命令提示符

slmgr /ipk <product key>

例如，若要安装 Windows Server 2022 Datacenter 版的产品密钥，请运行以下命令，然后按 Enter：

Windows 命令提示符

slmgr /ipk WX4NM-KYWYW-QJJR4-XV3QB-6VM33

用批量许可证密钥通

在下表中，可找到 Windows 每个版本的 GVLK。 LTSC 是长期服务渠道，而 LTSB 是 Long-Term Servicing Branch 。

Windows Server LTSC

Windows Server 半年频道

Windows Server，版本 20H2、2004、1909、1903 和 1809

 重要

Windows Server 版本 20H2 已于 2022 年 8 月 9 日终止服务，不再接收安全更新。 这包括停用 Windows Server 半年频道 (SAC)，不再提供未来版本。

使用 Windows Server SAC 的客户应迁移到 Azure Stack HCI。 或者，客户可使用 Windows Server 的长期服务渠道。

Windows 11 和 Windows 10（半年频道）

有关受支持的版本和服务终止日期的信息，请参阅 Windows 生命周期情况说明书。

Windows 企业版 LTSC 和 LTSB

早期版本的 Windows Server

Windows Server 版本 1803

Windows Server 版本 1709

Windows Server 2012 R2

Windows Server 2012

Windows Server 2008 R2

Windows Server 2008

早期版本的 Windows 客户端

Windows 8.1

Windows 8

Windows 7

Windows Vista

Windows操作提示

以下操作均假设你使用管理员权限的命令行CMD

查询当前激活信息/系统版本（确保是支持KMS的版本）：
解读微软ISO镜像文件名含义

slmgr /dlv

安装对应GVLK密钥（如果是从VLSC下载VL版本已经内置，不需要安装）
注:VL版本的镜像文件名是SW_DVD开头。MSDN下的是测试版本不是VL版本。

slmgr /ipk xxxxx-xxxxx-xxxxx-xxxxx-xxxxx

设置KMS服务器地址

slmgr /skms kms.example.com

手动执行激活请求(KMS服务正常的话，手动点立即激活一样效果，不点过一段时间也会自己请求)

slmgr /ato

查询过期时间

slmgr /xpr

更多命令可以输入slmgr后回车查看。

Office 2010 批量激活疑难解答

适用于： Office 2010

上一次修改主题： 2016-11-29

您可以了解如何解决在激活 Microsoft Office 2010 时遇到的问题。不过在阅读本文之前，我们建议您首先阅读 Office 2010 的批量激活概述、规划 Office 2010 的批量激活、部署 Office 2010 的批量激活和 Office 2010 中配置客户端计算机的工具。

 重要

该信息适用于 Office 2010 的批量许可版本，而不适用于基于订阅的 Office Professional Plus for Office 365。

本文内容：

激活错误代码

常规激活

用户看到激活通知

Backstage 视图中的许可信息未更新

KMS 客户端密钥

MAK 激活问题

对于 Windows XP，MAK 激活失败

Office 2010 客户端在通过已验证代理连接到网络时未激活

KMS 激活问题

Office 2010 KMS 客户端未激活

KMS 主机未激活

对于要激活的客户端计算机，KMS 主机上的客户端激活请求计数不够高

无法访问 KMS 主机

激活错误代码

错误代码可帮助解决激活问题。如果用户看到包含激活通知的对话框，则错误代码可能会显示在该对话框的左下部分。获得错误代码的另一种方式是在客户端计算机上运行 ospp.vbs /act 来尝试激活。如果激活失败，则会报告错误代码。使用带有相应错误代码的 ospp.vbs /ddescr 来接收错误消息。有关 ospp.vbs 脚本的详细信息，请参阅Office 2010 中配置客户端计算机的工具。

常规激活

下面是常规激活问题及它们的解决方法。

用户看到激活通知

激活通知对话框通常在 Office 2010 的副本尚未激活时出现。该对话框的左下部分将显示一个错误代码，可帮助您解决激活问题。在安装后 25 天之前，不会显示对话框，安装 25 天后，用户将看到一个通知对话框。如果 Office 2010 在安装 30 天后未激活，则通知对话框将包含红色标题栏。

在安装 Office 2010 时，您必须使用多次激活密钥 (MAK) 或连接到 Intranet 上的 KMS 主机的密钥管理系统 (KMS) 将其激活。

如果安装 MAK 密钥，则必须以联机方式激活 Office 2010。

Office 2010 客户端软件包括一个嵌入的 KMS 客户端密钥。当 Office 2010 KMS 客户端在 Intranet 上自动发现 Office 2010 KMS 主机，并且至少五个 Office 2010 KMS 客户端已请求通过 KMS 主机请求激活之后，将会自动激活 KMS 客户端。

Backstage 视图中的许可信息未更新

若要显示许可信息，请在“文件”菜单上单击“帮助”。您必须重新启动 Office 2010 应用程序，许可信息才能更新。例如，如果您打开 Microsoft Word 2010，然后单击“文件”菜单上的“帮助”，您可能发现需要激活该产品。如果您使用 ospp.vbs /act 或批量激活管理工具 (VAMT) 2.0 (https://www.microsoft.com/downloads/zh-cn/details.aspx?familyid=ec7156d2-2864-49ee-bfcb-777b898ad582) 进行激活，则必须重新启动 Word 2010，才能看到该产品已经激活，即使 Office 2010 已处于许可状态也是如此。有关 ospp.vbs 脚本的详细信息，请参阅 Office 2010 中配置客户端计算机的工具。

KMS 客户端密钥

所有 Office 2010 批量产品都预安装了 KMS 客户端密钥。如果您对某产品输入了 MAK 密钥，但希望将激活方法改回 KMS，请使用下文表格中提供的相应 KMS 客户端密钥。建议您使用 VAMT 2.0 (https://www.microsoft.com/downloads/zh-cn/details.aspx?familyid=ec7156d2-2864-49ee-bfcb-777b898ad582) 输入密钥。也可以使用 ospp.vbs /inpkey 输入密钥。有关 ospp.vbs 脚本的详细信息，请参阅 Office 2010 中配置客户端计算机的工具。

对于 Office 2010 套件，套件中的所有产品只需要一个密钥。例如，如果您使用 Microsoft Office Professional Plus 2010，则必须为整个套件输入 Office Professional Plus 2010 密钥，且只能输入此密钥。

如果您要部署 Microsoft Visio 2010，输入的密钥将决定可用的功能。有关详细信息，请参阅部署 Office 2010 的批量激活中的部署 Visio 2010。

下表显示了 Office 2010 套件 和独立产品的 KMS 客户端密钥。

展开表

套件

Office Professional Plus 2010

VYBBJ-TRJPB-QFQRF-QFT4D-H3GVB

Office Standard 2010

V7QKV-4XVVR-XYV4D-F7DFM-8R6BM

Office Home and Business 2010

D6QFG-VBYP2-XQHM7-J97RH-VVRCK

独立产品

Access 2010

V7Y44-9T38C-R2VJK-666HK-T7DDX

Excel 2010

H62QG-HXVKF-PP4HP-66KMR-CW9BM

SharePoint Workspace 2010

QYYW6-QP4CB-MBV6G-HYMCJ-4T3J4

InfoPath 2010

K96W8-67RPQ-62T9Y-J8FQJ-BT37T

OneNote 2010

Q4Y4M-RHWJM-PY37F-MTKWH-D3XHX

Outlook 2010

7YDC2-CWM8M-RRTJC-8MDVC-X3DWQ

PowerPoint 2010

RC8FX-88JRY-3PF7C-X8P67-P4VTT

Project Professional 2010

YGX6F-PGV49-PGW3J-9BTGG-VHKC6

Project Standard 2010

4HP3K-88W3F-W2K3D-6677X-F9PGB

Publisher 2010

BFK7F-9MYHM-V68C7-DRQ66-83YTP

Word 2010

HVHB3-C6FV7-KQX9W-YQG79-CRY7T

Visio

Visio Premium 2010

D9DWC-HPYVV-JGF4P-BTWQB-WX8BJ

Visio Professional 2010

7MCW8-VRQVK-G677T-PDJCM-Q8TCP

Visio Standard 2010

767HD-QGMWX-8QTDB-9G3R2-KHFGJ

MAK 激活问题

本节论述 MAK 激活问题以及如何解决这些问题。

对于 Windows XP，MAK 激活失败

相关错误代码：0x8007001

如果安装了守护程序工具（例如 CD 仿真软件），则会有一个注册表项防止获取硬件 ID。解决方法如下：

在“开始”菜单上，单击“运行”，然后键入 regedit。

在注册表编辑器中，搜索以下注册表项：HKLM\SYSTEM\CURRENTCONTROLSET\CONTROL\CLASS\{4D36E967-E325-11CE-BFC1-08002BE10318}

查找 UpperFilters，其类型为 REG_MULTI_SZ。

双击“UpperFilters”，然后在“值”数据下，将 PartMgr 添加到列表的顶部。单击“确定”。

重新启动计算机。

启动任何 Office 2010 应用程序，并按照提示进行激活。

 重要

如果要使用 VAMT 或 Office 软件保护平台脚本 (ospp.vbs) 进行激活，您必须首先启动 Office 2010 应用程序，以便启动 OSPP 服务。

有关如何解决此问题的信息，请参阅 Microsoft 知识库文章 916180：您尝试设置 Xbox 360 控制台作为 Media Center Extender，但安装程序未启动 (https://support.microsoft.com/kb/916180/zh-cn)。

 备注

尽管知识库文章 916180 描述的修补程序并不特定于 Office 和激活，但该修补程序与 Windows XP 相关，并且适用于此问题。

Office 2010 客户端在通过已验证代理连接到网络时未激活

独立的 MAK 激活需要 Internet 连接。如果 Office 2010 客户端通过已验证代理连接到 Internet，则您必须通过电话激活该客户端。有关如何解决此问题的详细信息，请参阅知识库文章 921471：尝试通过 Internet 激活 Windows Vista 或 Windows Server 2008 时激活失败 (https://support.microsoft.com/kb/921471/zh-cn)。

KMS 激活问题

本节论述 MAK 激活问题以及如何解决这些问题。

Office 2010 KMS 客户端未激活

Office 2010 密钥管理服务 (KMS) 客户端之所以未激活，原因可能有很多。本节描述问题以及如何解决这些问题。

KMS 主机未激活

相关错误代码：0xC004F041

必须首先激活 KMS 主机，然后才能激活 KMS 客户端。有关详细信息，请参阅部署 Office 2010 的批量激活中的准备和配置 KMS 主机。您必须运行 KeyManagementServiceHost.exe（可从 Microsoft Office 2010 KMS 主机许可证包 (https://www.microsoft.com/downloads/zh-cn/details.aspx?familyid=97b7b710-6831-4ce5-9ff5-fdc21fe8d965) 下载）。然后，输入 Office 2010 KMS 主机密钥并激活 KMS 主机。

 备注

在 KMS 主机上启用防火墙时，默认 TCP 通信端口号为 1688。

如果使用 slmgr.vbs，则必须在命令内激活 KMS 主机，并包括以下 Office 2010 激活 ID：

cscript slmgr.vbs /ato bfe7a195-4f8f-4f0b-a622-cf13c7d16864

对于要激活的客户端计算机，KMS 主机上的客户端激活请求计数不够高

相关错误代码：0xC004F038

Office 2010 KMS 主机至少必须从五个 Office 2010 KMS 客户端接收激活请求，然后才能激活该网络上的 KMS 客户端。如果 KMS 主机收到的请求数不超过五个，将不会激活 KMS 客户端。如果将 Office 2010 部署到超过五台计算机，则它们的初始激活请求将用于增大计数。如果激活失败，则计算机将尝试在两个小时后激活。在那时，如果 KMS 主机有足够的计数，则激活将成功。若要在 KMS 客户端上手动触发激活，请运行 ospp.vbs /act。有关 ospp.vbs 脚本的详细信息，请参阅Office 2010 中配置客户端计算机的工具。

若要确定 KMS 主机上的当前计数，请在命令提示符处（使用管理员权限）运行以下命令：

cscript slmgr.vbs /dlv bfe7a195-4f8f-4f0b-a622-cf13c7d16864

若要激活 KMS 客户端，显示的当前计数必须大于或等于 5。输出应与下面类似：

复制

Name: Microsoft Office 2010, KMSHost edition

Description: Microsoft Office 2010 KMS, VOLUME_KMS channel

Activation ID: bfe7a195-4f8f-4f0b-a622-cf13c7d16864

Application ID: 59a52881-a989-479d-af46-f275c6370663

Extended PID: 55041-00096-199-000004-03-1033-7600.0000-3632009

Installation ID: 008585014214769124199722184000850026888810090785321136

Processor Certificate URL: https://go.microsoft.com/fwlink/?linkid=88342&clcid=0x804: https://go.microsoft.com/fwlink/?linkid=88343&clcid=0x804: https://go.microsoft.com/fwlink/?linkid=88345&clcid=0x804: https://go.microsoft.com/fwlink/?linkid=88344&clcid=0x804: RP3HH

License Status: Licensed

Remaining Windows rearm count: 1

Trusted time: 12/29/2009 1:45:54 PM

Key Management Service is enabled on this computer

    Current count: 0

    Listening on Port: 1688

    DNS publishing enabled

    KMS priority: Normal

Key Management Service cumulative requests received from clients

    Total requests received: 0

    Failed requests received: 0

    Requests with License Status Unlicensed: 0

    Requests with License Status Licensed: 0

    Requests with License Status Initial grace period: 0

    Requests with License Status License expired or Hardware out of tolerance: 0

    Requests with License Status Non-genuine grace period: 0

    Requests with License Status Notification: 0

运行 KMS 客户端的操作系统确定 KMS 客户端如何发送激活请求。

对于运行于 Windows Vista、Windows 7、Windows Server 2008 或 Windows Server 2008 R2 下的 Office 2010 KMS 客户端   在安装 Office 2010 之后，无论 Office 2010 是否在运行，Office 软件保护平台 (OSPP) 服务都会每隔两个小时将激活请求自动发送到 KMS 主机，直至进行激活为止。当其中有五个 KMS 客户端连接到企业网络并成功针对 KMS 主机激活之后，KMS 客户端即被激活。以后连接到企业网络的客户端也会激活。未在企业网络上运行的 KMS 客户端（例如，家庭中的 KMS 客户端）一旦连接到网络便可激活。

对于运行于 Windows XP 或 Windows Server 2003 下的 Office 2010 KMS 客户端   当计算机连接到企业网络并且启动 Office 2010 应用程序时，将发送激活请求。启动 Office 2010 应用程序时将启动 OSPP 服务，后者将持续运行，直至计算机重新启动为止。尽管 OSPP 服务在运行，但在 30 天宽限期内，仍会每隔两小时自动发送激活请求。如果这些 KMS 客户端连接到企业网络，并且没有启动任何 Office 2010 应用程序，则不会向 KMS 主机发送激活请求。可通过两种方式将激活请求手动发送到 KMS 主机来增加当前计数。在每个 KMS 客户端上，在连接到企业网络的同时执行以下任一操作：

启动 Office 2010 应用程序。这将会发送激活请求并启动 OSPP 服务。

从命令行中（使用管理员权限）运行 cscript ospp.vbs /act。有关 ospp.vbs 脚本的详细信息，请参阅 Office 2010 中配置客户端计算机的工具。

无法访问 KMS 主机

相关错误代码：0xC004F041

如果希望 KMS 客户端使用 KMS 主机的自动发现，请查看 Windows 批量激活部署指南（该链接可能指向英文页面） (https://technet.microsoft.com/zh-cn/library/dd772269.aspx)（该链接可能指向英文页面） 以确保 DNS 配置正确无误。确保 KMS 主机已连接到网络，并且 KMS 客户端可访问该主机。

作为 KMS 客户端上的一项测试，您可能希望使用 ospp.vbs /sethst 来指定 KMS 主机计算机名称。然后，运行 ospp.vbs /act 将激活请求直接发送到 KMS 主机。如果此操作成功，则问题可能在于 KMS 主机自动发现。测试完成后，请记住使用 ospp.vbs /remhst 移除 KMS 主机名。

See Also

Concepts

Office 2010 的批量激活概述

规划 Office 2010 的批量激活

部署 Office 2010 的批量激活

Office 2010 中配置客户端计算机的工具

Other Resources

Office 2010 批量激活论坛（该链接可能指向英文页面）

Office 2010 论坛（该链接可能指向英文页面）

用于基于 KMS 和 Active Directory 的 Office、Project 和 Visio 激活的 GVLK

项目2024/10/15

1 个参与者

反馈

本文内容

GVLK for Office LTSC 2024GVLK for Office LTSC 2021Office 2019 的 GVLKOffice 2016 的 GVLK相关文章

适用于：Office LTSC 2024、Office LTSC 2021、Office 2019 和 Office 2016 的批量许可版本，包括 Project 和 Visio

默认情况下，批量许可版本的 Office（如 Office LTSC 2024）随通用批量许可证密钥 (GVLK) 一起安装。 GVLK 使 Office 能够针对密钥管理服务 (KMS 自动发现并激活) 主计算机或 Active Directory 基础结构。

 重要

这些许可证密钥不能用于在家激活 Office 的个人副本。 有关 Office 个人副本的产品密钥的信息，请参阅 将产品密钥与 Office 配合使用。

GVLK for Office LTSC 2024

 备注

Microsoft Publisher 未包含在 Office LTSC 2024 中。 此更改是由于发布服务器的计划停用，在 2026 年 10 月之后将不再支持该版本。 有关详细信息，请参阅 Microsoft发布服务器在 2026 年 10 月之后不再受支持。

展开表

产品GVLK

Office LTSC 专业增强版 2024XJ2XN-FW8RK-P4HMP-DKDBV-GCVGB

Office LTSC 标准版 2024V28N4-JG22K-W66P8-VTMGK-H6HGR

Project Professional 2024FQQ23-N4YCY-73HQ3-FM9WC-76HF4

Project Standard 2024PD3TT-NTHQQ-VC7CY-MFXK3-G87F8

Visio LTSC Professional 2024B7TN8-FJ8V3-7QYCP-HQPMV-YY89G

Visio LTSC Standard 2024JMMVY-XFNQC-KK4HK-9H7R3-WQQTV

Access LTSC 202482FTR-NCHR7-W3944-MGRHM-JMCWD

Excel LTSC 2024F4DYN-89BP2-WQTWJ-GR8YC-CKGJG

Outlook LTSC 2024D2F8D-N3Q3B-J28PV-X27HD-RJWB9

PowerPoint LTSC 2024CW94N-K6GJH-9CTXY-MG2VC-FYCWP

Skype for Business LTSC 20244NKHF-9HBQF-Q3B6C-7YV34-F64P3

Word LTSC 2024MQ84N-7VYDM-FXV7C-6K7CC-VFW9J

GVLK for Office LTSC 2021

展开表

产品GVLK

Office LTSC Professional Plus 2021FXYTK-NJJ8C-GB6DW-3DYQT-6F7TH

Office LTSC Standard 2021KDX7X-BNVR8-TXXGX-4Q7Y8-78VT3

Project Professional 2021FTNWT-C6WBT-8HMGF-K9PRX-QV9H8

Project Standard 2021J2JDC-NJCYY-9RGQ4-YXWMH-T3D4T

Visio LTSC Professional 2021KNH8D-FGHT4-T8RK3-CTDYJ-K2HT4

Visio LTSC Standard 2021MJVNY-BYWPY-CWV6J-2RKRT-4M8QG

Access LTSC 2021WM8YG-YNGDD-4JHDC-PG3F4-FC4T4

Excel LTSC 2021NWG3X-87C9K-TC7YY-BC2G7-G6RVC

Outlook LTSC 2021C9FM6-3N72F-HFJXB-TM3V9-T86R9

PowerPoint LTSC 2021TY7XF-NFRBR-KJ44C-G83KF-GX27K

Publisher LTSC 20212MW9D-N4BXM-9VBPG-Q7W6M-KFBGQ

Skype for Business LTSC 2021HWCXN-K3WBT-WJBKY-R8BD9-XK29P

Word LTSC 2021TN8H9-M34D3-Y64V9-TR72V-X79KV

Office 2019 的 GVLK

展开表

产品GVLK

Office 专业增强版 2019

NMMKJ-6RK4F-KMJVX-8D9MJ-6MWKP

2019 Office Standard

6NWWJ-YQWMR-QKGCB-6TMB3-9D9HK

Project Professional 2019

B4NPR-3FKK7-T2MBV-FRQ4W-PKD2B

2019 Project Standard

C4F7P-NCP8C-6CQPT-MQHV9-JXD2M

2019 Visio Professional

9BGNQ-K37YR-RQHF2-38RQ3-7VCBB

2019 Visio Standard

7TQNQ-K3YQQ-3PFH7-CCPPM-X4VQ2

Access 2019

9N9PT-27V4Y-VJ2PD-YXFMF-YTFQT

Excel 2019

TMJWT-YYNMB-3BKTF-644FC-RVXBD

Outlook 2019

7HD7K-N4PVK-BHBCQ-YWQRW-XW4VK

PowerPoint 2019

RRNCX-C64HY-W2MM7-MCH9G-TJHMQ

Publisher 2019

G2KWX-3NW6P-PY93R-JXK2T-C9Y9V

Skype for Business 2019

NCJ33-JHBBY-HTK98-MYCV8-HMKHJ

Word 2019

PBX3G-NWMT6-Q7XBW-PYJGG-WXD33

 备注

没有新的 2019 版 OneNote，但 OneNote 版本随 Office 2019 一起安装。 有关详细信息，请参阅 OneNote 的部署指南。

Office 2016 的 GVLK

展开表

产品GVLK

Office Professional Plus 2016

XQNVK-8JYDB-WJ9W3-YJ8YR-WFG99

Office Standard 2016

JNRGM-WHDWX-FJJG3-K47QV-DRTFM

Project Professional 2016

YG9NW-3K39V-2T3HJ-93F3Q-G83KT

Project Standard 2016

GNFHQ-F6YQM-KQDGJ-327XX-KQBVC

Visio Professional 2016

PD3PC-RHNGV-FXJ29-8JK7D-RJRJK

Visio Standard 2016

7WHWN-4T7MP-G96JF-G33KR-W8GF4

Access 2016

GNH9Y-D2J4T-FJHGG-QRVH7-QPFDW

Excel 2016

9C2PK-NWTVB-JMPW8-BFT28-7FTBF

OneNote 2016

DR92N-9HTF2-97XKM-XW2WJ-XW3J6

Outlook 2016

R69KK-NTPKF-7M3Q4-QYBHW-6MT9B

PowerPoint 2016

J7MQP-HNJ4Y-WJ7YM-PFYGF-BY6C6

Publisher 2016

F47MM-N3XJP-TQXJ9-BP99D-8 837 K

Skype for Business 2016

869NQ-FJ69K-466HW-QYCP2-DDBV6

Word 2016

WXY84-JN2Q9-RBCCQ-3Q3J3-3PFJ6

相关文章

Office 批量激活概述使用 KMS 激活批量许可版本的 Office使用 Active Directory 激活批量许可版本的 Office

反馈

此页面是否有帮助？

是

否

提供产品反馈

FastAdmin的自由度还是很高的，只是文档太生涩、语焉不详。

网上很多关于表格的自定义按钮都是要去改框架的JS，这样的操作总归不是最完美的办法，最好的办法是不修改框架的文件，全部在自己的文件里来定义。

本文提供一个思路，与大家共勉。

在实际的使用中，我需要建立一个关于附件的表格，需要添加一个“预览”按钮，并提供“编辑”和“删除”的操作。

其中“预览”按钮是自定义添加的，“编辑”按钮是对原框架编辑按钮的重写，“删除”按钮使用原生的功能。

先上代码：

var custom_button_attachment = {
    buttons: [{
        name: 'attachment-view', icon: 'fa fa-eye', title: '查看/下载', text: '查看/下载',
        extend: 'data-toggle="tooltip" data-container="body"', classname: 'btn btn-info btn-xs attachment-view'
    }, {
        name: 'attachment-edit', icon: 'fa fa-pencil',
        title: '编辑', extend: 'data-toggle="tooltip" data-container="body"', classname: 'btn btn-xs btn-success attachment-edit'
    }, {
        name: 'attachment-delete', icon: 'fa fa-trash',
        title: '删除', extend: 'data-toggle="tooltip" data-container="body" data-url="' + this.initOptions.extend.attachment_del_url + '"', classname: 'btn btn-xs btn-danger attachment-delete'
    },],
    api: {
        getBlog: function (url, data, callback) {
            var aurl = url;
            var httpRequest = new XMLHttpRequest();
            httpRequest.open('POST', aurl, true);
            httpRequest.setRequestHeader("Content-type", "application/json");
            httpRequest.responseType = "arraybuffer";
            var obj = data;
            httpRequest.onload = function () {
                callback(httpRequest);
            };
            httpRequest.send(JSON.stringify(obj));
        }
    },
    formatter: {
        operate: function (value, row, index) {
            return Table.api.buttonlink(this, this.buttons, value, row, index, 'operate');
        },
        size: function (value, row, index) {
            if (value < 1024) {
                return `${value}B`;
            } else if (value < 1024 * 1024) {
                return (value / 1024).toFixed(2).concat('KB');
            } else if (value < 1024 * 1024 * 1024) {
                return (value / 1024 / 1024).toFixed(2).concat('MB');
            } else {
                return (value / 1024 / 1024 / 1024).toFixed(2).concat('GB');
            }
        },
        filename: function (value, row, index) {
            return '<img src="' + Fast.api.fixurl("ajax/icon") + "?suffix=" + row.imagetype + '" alt="' + row.name + '" class="attachment-view">' + '<button class="btn btn-link attachment-view">' + value + '</button>';
        },
    },
    events: {
        operate: {
            'click .attachment-view': function (e, value, row, index) {
                var table = $(this).closest('table');
                var options = table.bootstrapTable('getOptions');
                var ids = row[options.id];
                row = $.extend({}, row ? row : {}, {});
                var url = options.extend.attachment_view_url;
                custom_button_attachment.api.getBlog(Table.api.replaceurl(Fast.api.fixurl(options.extend.attachment_data_url), row, table), {'url': row.url}, function (res) {
                    var blob = new Blob([res.response], {type: row.mime});
                    let bloburl = URL.createObjectURL(blob);
                    Fast.api.open(Table.api.replaceurl(url, row, table), $(this).data("original-title") || $(this).attr("title") || __('Edit'), {
                        area: area, shade: shade, success: function (e) {
                            $(window.frames[0].document, e).find('#view-container').attr('src', bloburl);
                            $(window.frames[0].document, e).find('#download-container').attr('href', bloburl);
                        }
                    });
                });
            },
            'click .attachment-edit': function (e, value, row, index) {
                e.stopPropagation();
                e.preventDefault();
                var table = $(this).closest('table');
                var options = table.bootstrapTable('getOptions');
                var ids = row[options.pk];
                row = $.extend({}, row ? row : {}, {ids: ids});
                var url = options.extend.attachment_edit_url;
                Fast.api.open(Table.api.replaceurl(url, row, table), $(this).data("original-title") || $(this).attr("title") || __('Edit'), $(this).data() || {});
            },
            'click .attachment-delete': Table.api.events.operate['click .btn-delone'],
        }
    },
};

说明一下：

定义一个自定义的按钮对象，包括buttons, api, formatter, events，其中

buttons定义三个按钮，就是表格中要显示的；

api里面写一些自己的方法，我这里是从服务器拉取文件内容；

formatter是对表格列的显示输出方法；

events是按钮的执行过程。

表格的初始化大概是这个样子的：

Table.api.init({
    search: true,
    advancedSearch: true,
    pagination: true,
    extend: {
        attachment_url: "attachment" + location.search,
        attachment_view_url: "attachment/action/view" + location.search,
        attachment_data_url: "attachment/action/data" + location.search,
        attachment_edit_url: "attachment/action/edit" + location.search,
        attachment_del_url: "attachment/action/del" + location.search,
        table: 'table-attachment',
    }
});

这里没有“edit_url”和“del_url”，而这两个url的定义恰恰是框架识别用于显示 编辑 和 删除 按钮的关键，没有这两个定义，按钮就不显示。但实际使用中，可能需要使用不同的名称来定义，本例就是如此。

表格的列定义大概是这样的：

var tableAttachment = $("#table-attachment");
tableAttachment.bootstrapTable({
    url: $.fn.bootstrapTable.defaults.extend.attachment_url,
    pk: 'hash', toolbar: "#toolbar-attachment", sortName: 'date', fixedColumns: true, fixedRightNumber: 1,
    search: false, showExport: false, commonSearch: false, showColumns: false,
    columns: [
        {
            align: 'left', field: 'name',
            title: '文件名',
            table: tableAttachment,
            events: custom_button_attachment.events.operate,
            formatter: custom_button_attachment.formatter.filename,
            buttons: custom_button_attachment.buttons,
            extend: 'data-toggle="tooltip" data-container="body"',
        },
        {
            field: 'size',
            title: '大小',
            table: tableAttachment,
            formatter: custom_button_attachment.formatter.size,
        },
        {
            field: 'date',
            title: '日期',
            table: tableAttachment,
            class: 'autocontent',
        },
        {
            field: 'operate',
            title: __('Operate'),
            table: tableAttachment,
            buttons: custom_button_attachment.buttons,
            events: custom_button_attachment.events.operate,
            formatter: custom_button_attachment.formatter.operate,
            extend: 'data-toggle="tooltip" data-container="body"',
        },
    ],
});

这样就是完整的自定义表格按钮的方法，上述代码都是在自己的js文件中，不需要去修改框架的js文件（require-table.js）。