Jenkins执行hg purge报错求助：hg未知命令‘purge’

云上老周

2026-5-13

解决Jenkins流水线执行hg purge报错的问题

这个问题我之前帮人排查过几次，核心原因基本都是Jenkins的运行环境和你手动打开的终端环境不一致导致的，下面给你一步步排查和解决的方案：

1. 检查Jenkins的PATH环境变量，确保指向正确的Mercurial安装路径

你在终端里能正常执行hg purge，说明你的终端PATH里已经包含了安装了purge插件的Mercurial目录，但Jenkins默认可能用的是不同的PATH（比如Jenkins以系统服务运行时，用的是系统用户的PATH，而非你当前登录用户的）。

在你的Jenkins流水线中添加一个调试步骤，输出当前的PATH：

bat 'echo %PATH%'

然后在你手动打开的Windows终端里执行同样的命令echo %PATH%，对比两者的输出，看Mercurial的安装目录（比如C:\Program Files\Mercurial）是否在Jenkins的PATH里。

如果Jenkins的PATH里没有这个目录，你可以在流水线里临时添加：
```
bat 'set PATH=C:\Program Files\Mercurial;%PATH% && hg purge --all -R D:\path'
```
（注意把C:\Program Files\Mercurial替换成你实际的Mercurial安装路径）
或者更彻底的方式：进入Jenkins的全局工具配置，找到Mercurial的配置项，手动指定你的Mercurial安装目录的完整路径，保存后重新运行流水线。

Mercurial的插件是通过配置文件启用的，而Jenkins运行时使用的用户（比如Local System或者专门的Jenkins服务用户）的Mercurial配置可能和你当前登录用户的不一样——你手动终端里的配置已经开启了purge，但Jenkins用户的配置没开。

在Jenkins流水线中执行命令，查看当前加载的Mercurial扩展：

bat 'hg showconfig extensions'

如果输出里没有purge=这一行，说明Jenkins用户的配置没启用purge插件。

方法一：修改Jenkins运行用户的Mercurial配置文件。找到该用户的Mercurial.ini（通常在C:\Users\<Jenkins用户名>\Mercurial.ini，如果是Local System用户，路径是C:\Windows\System32\config\systemprofile\Mercurial.ini），在文件中添加以下内容：
```
[extensions]
purge=
```
方法二：在执行hg purge命令时，强制启用插件，不需要修改配置文件：
```
bat 'hg --config extensions.purge= purge --all -R D:\path'
```

如果你安装了Jenkins的Mercurial插件，它可能自带了一个Mercurial版本，而这个版本没有包含purge插件。这种情况下，你需要让Jenkins使用你本地安装的、带有purge插件的Mercurial版本。

进入Jenkins的全局工具配置，找到Mercurial的配置项，选择“Install automatically”以外的选项，手动指定你本地Mercurial的安装路径，保存后重新运行流水线。

如果上面的方法都不想折腾，你可以直接在流水线里用Mercurial可执行文件的完整路径来执行命令，彻底绕开PATH的问题：

bat '"C:\Program Files\Mercurial\hg.exe" purge --all -R D:\path'

（同样，替换成你实际的hg.exe路径）

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