初学者Mercurial：权威的实用指南

Question

受到Git初学者的启发： 权威的实用指南 。

这是有关使用Mercurial面向初学者进行实际使用的信息的汇总。

初学者-接触过源代码控制却不太了解的程序员。

实用-涵盖大多数用户经常遇到的情况-创建存储库，分支，合并，从/到远程存储库的拉/推等

注意事项 ：

• 说明如何完成某件事，而不是如何实现。
• 每个答案处理一个问题。
• 尽可能清楚简洁地回答。
• 编辑/扩展现有答案，而不是针对同一主题创建新答案。
• 请为想要了解更多信息的人提供指向Mercurial Wiki或HG Book的链接。

问题：

安装/设置

• 如何安装Mercurial？
• 如何设置Mercurial？
• 如何创建新的项目/存储库？
• 如何配置它以忽略文件？

使用代码

• 您如何获得最新代码？
• 您如何签出代码？
• 您如何提交更改？
• 您如何查看未提交的内容或当前代码库的状态？
• 如何从存储库中删除文件？
• 您如何销毁不需要的提交？
• 您如何比较文件的两个修订，或者当前文件和先前的修订？
• 您如何查看文件或存储库的修订历史？
• 您如何处理二进制文件（例如，visio文档或编译器环境）？
• 如何合并在“同一时间”更改的文件？
• 您如何还原变更集？
• 您如何返回到以前的代码版本？
• 您如何从特定变更集中提取补丁？
• 如何记录未使用Mercurial命令重命名或删除文件的情况？

标记，分支，发布，基准

• 如何为一组特定的文件“标记”，“标记”或“发布”一组特定的修订版本，以便您以后总是可以拉出该修订版本？
• 您如何拉特定的“发布”？
• 您如何分支？
• 您如何合并分支？
• 如何将一个分支的部分合并到另一个分支？

其他

• 适用于Mercurial的GUI / IDE插件好吗？ 优点缺点？
• 初学者应该知道的其他常见任务吗？
• 如何与Subversion交互？

其他水银参考

• 水星：权威指南
• 水星维基
• 认识Mercurial | Peepcode截屏
• 掌握水银| TekPub截屏
• Hg Init-地面Mercurial教程

Answer 1

如何配置它以忽略文件？

忽略是在存储库根目录中的普通文本文件.hgignore中配置的。 像添加普通文件一样添加它：

hg add .hgignore

有两种语法选项可用于文件匹配，即glob和regexp。 glob是类unix的文件名扩展，而regexp是正则表达式。 通过添加syntax: glob或syntax: regexp syntax: glob激活一行。 接下来的所有行将使用该语法，直到下一个语法标记。 您可以根据需要使用任意数量的语法标记。 默认语法为regexp，因此，如果仅使用regexp，则不需要任何语法标记。

您可以使用＃添加评论

例：

# python temporary files
syntax: glob
*.pyc

#editor autosaves
*~

# temporary data
syntax: regexp
temp

忽略仅适用于非托管文件（即尚未签入的文件）。 要忽略受版本控制的文件，可以使用-I和-X开关。

Answer 2

您如何查看未提交的内容或当前代码库的状态？

要查看已更改的文件列表：

$ hg status

这将打印每个已更改的文件及其状态，其中包括：

• M修改。 文件已更改，并且更改尚未提交。
• A添加。 该文件以前没有被跟踪过，但是如果您提交Mercurial，它将开始跟踪它。
• R移除。 该文件以前曾被跟踪，但是如果您提交Mercurial，则在此以后的提交中将停止跟踪它。
• ? -不知道 Mercurial当前未跟踪该文件。 除非使用hg add来添加，否则提交不会对其产生任何影响。
• ! - 失踪。 该文件已被跟踪，但是Mercurial在工作副本中找不到它。

要查看对文件实际进行的更改：

$ hg diff

Answer 3

如何创建新的项目/存储库？

$ hg init my-repository

Answer 4

如何与Subversion交互？

有三种方法：

---

convert扩展会将现有的Subversion存储库克隆到Mercurial存储库中。 它带有Mercurial。 它大致如下所示：

hg convert <Subversion URL or directory> <path to new Mercurial repository>

例如，这将抓住SixApart memcached存储库的主干。

hg convert http://code.sixapart.com/svn/memcached/trunk

该扩展可以将新版本从Subversion存储库逐步引入到Mercurial存储库中（有点像pull）。 但是，它不支持采用Mercurial修订版本并将其发送回Subversion（不推送）。 [XXX：如果错误，请更正] 。

---

hgsubversion扩展名 。 在许多方面，它是最复杂的解决方案，因为它使用Subversion API与Subversion存储库进行通信。 它的目标是成为 HG-SVN桥。 它允许对修订版本进行完整的往返操作（完整的克隆，提取和推送），但是在撰写本文时[XXX：如果/如果变得不正确 ，请对此进行修改]它仍在开发中，尚无正式版本。 因此，它仅适用于最新的Mercurial（在撰写本文时为1.3）。

• 它映射标签和分支（所有标签之前都带有tags/以将它们与等效命名的分支区分开）。
• 它维护了一个特殊的分支closed-branches用于关闭在Subversion中删除的分支。
• 它要求按照主干/分支/标签的约定对Subversion存储库进行布局。
• 该命令集通常是hg svn <subcommand>尽管它的目的是集成到您不需要'svn'部分的程度（即，它希望像对待任何其他Mercurial存储库一样尽可能多地处理Subversion克隆）。 ;

它是这样的：

克隆：

hg svnclone <Subversion URL> 

或（仅适用于svn://网址）

hg clone <svn:// URL>

拉：

hg svn pull

推：

hg svn push

传入：

hg svn incoming

传出：

hg svn outgoing

检出整个存储库：

hg svnclone http://code.sixapart.com/svn/memcached

---

hgsvn实用程序（位桶 树 ）。 直到最近，这仅允许您克隆和提取Subversion存储库，但是从hgsvn 0.1.7它支持push。 [我不知道做的如何推动。 有更多经验的人都应该对此进行更新。]它具有以下显着功能：

• 它为每个SVN标签生成一个Mercurial标签。
• 它在每个变更集上放置一个本地标记，以标记其SVN版本。
• 它将每个Mercurial修订版本放在以SVN分支命名的命名分支上。 例如branches/some-feature就像hg branch some-feature 。 它将中继放在trunk （即，Mercurial默认分支上没有任何内容，除非用户明确切换到该分支。）
• 它将尝试识别分支和标签，并创建它们，但如果不能创建，它将跳过它们。 当Subversion存储库不遵循常规的主干/分支/标签布局时，这很方便。

它是这样的：

克隆：

hgimportsvn <Subversion URL>

拉：

hgpullsvn

推：

hgpushsvn

传入：

hgpullsvn -n

传出：

hgpushsvn -n

检出整个存储库：

hgimportsvn http://code.sixapart.com/svn/memcached

仅检查树干：

hgimportsvn http://code.sixapart.com/svn/memcached/trunk

Answer 5

您如何比较文件的两个修订，或者当前文件和先前的修订？

两者都使用hg diff 。 使用hg diff时，工作副本中的所有更改都将显示，并且提示（最新提交）会显示。

对于“您如何比较文件的两个修订版本？”

$ hg diff -r{rev1} -r{rev2} {file.code}

上面的命令将显示“ file.code”的rev1和rev2之间的不同。

对于“如何比较当前文件和以前的版本？”

$ hg diff {file.code}

上面的命令将显示当前版本的“ file.code”和最新修订版（最新提交）之间的差异。

：D

Answer 6

您如何分支？

$ hg分支我的分支

要么

$ hg clone原存储库my-branch

尽管应该注意的是， 分支创建了一个“虚拟”目录（即文件保持不变，但是hg将它们视为系统内部不同），而克隆创建了实际的完整副本。 严格来说， 克隆不是分支。

Answer 7

如何为一组特定的文件“标记”，“标记”或“发布”一组特定的修订版本，以便您以后可以随时将其拉出？

$ hg tag my-tag

您还可以克隆存储库以创建特殊的标记存储库。

$ hg clone working-repository my-tag-repository

Answer 8

适用于Mercurial的GUI / IDE插件好吗？

图形用户界面

• TortoiseHg适用于几乎所有操作系统。 包括Windows资源管理器集成。 它也可以在Linux和其他一些OS（包括Max OS X）上运行。它的界面有点笨拙，一开始使用起来有点麻烦，但是它非常完整且功能强大。
• Murky在Mac OS X 10.5或更高版本上运行。 Murky非常适合浏览存储库和基本命令，但是您还需要知道如何使用命令行。
• MacHg是一个不错的Mac OS X Gui，具有比Murky更多的功能和完善的功能，但是您仍然需要使用命令行。
• SourceTree最初是Mac客户端，最近才提供Windows版本。 非常漂亮的UI（至少在OS X上），支持大多数Hg功能，包括搁置。

外挂程式

• VisualHG for Visual Studio
• 适用于Visual Studio 2008/2010的HgSccPackage
• Eclipse的MercurialEclipse
• 对NetBeans的Mercurial支持
• Mercurial支持 Sublime Text

Answer 9

您如何合并分支？

$ cd repository-where-i-want-to merge
$ hg pull branch-i-want-to-merge
$ hg merge # if necessary

Answer 10

如何安装Mercurial？

如果您已从Linux上的源代码安装或使用Windows安装程序，请进行良好的编辑。

Mac OS X 10.4（Tiger），10.5（Leopard）

使用Python的easy_install（通过Setuptools ）：

sudo easy_install mercurial

它会找到最新版本（在撰写本文时为1.3.1），并安装在：

/Library/Frameworks/Python.framework/Versions/2.6/bin/

使用Python 2.6时，它也绕过了Mercurial OS X安装程序包 （截至2009年7月26日为1.2.1），抱怨它需要Python 2.5。 从文档中可以看出，Fink和Macports安装了1.2版。

的Linux

大多数显式Linux软件包似乎都滞后于当前版本，因此请使用easy_install （如上所述）或下载Mercurial tarball ，提取档案文件，更改为mercurial目录并运行：

$ make
$ sudo make install    # do a system-wide install
$ hg debuginstall      # sanity check
$ hg                   # see help

（摘自Mercurial，一个分布式版本控制系统 ）

视窗

有一个最新版本的Mercurial的二进制包 。 TortoiseHg是Windows Shell扩展，用于并安装Mercurial。 Cygwin也可以安装Mercurial。

或者，（指令太长，因此在此处链接），您可以从源代码构建优化或纯Python版本的Mercurial。

Answer 11

您如何获得最新代码？

Mercurial记得从中克隆存储库的位置（在.hg / hgrc中），因此您可以简单地运行：

hg pull

从原始存储库中提取最新代码。 （这不会更新工作目录）

hg update

更新工作目录。

hg pull -u

同时执行拉取和更新。

Answer 12

您如何签出代码？

hg clone [OPTION]... SOURCE [DEST]

选项可以是：

 -U --noupdate      the clone will only contain a repository (no working copy)
 -r --rev           a changeset you would like to have after cloning
    --pull          use pull protocol to copy metadata
    --uncompressed  use uncompressed transfer (fast over LAN)
 -e --ssh           specify ssh command to use
    --remotecmd     specify hg command to run on the remote side

其中source是位于资源库中的原始文件的来源，其中可以是远程URL或文件系统目录。 例如：

• http://bitbucket.org/scrum8/django-wmd-editor/
• / home /用户名/存储库/ django-wmd-editor /
• ssh：//myusername@scrum8.com/~/repository/django-wmd-editor/

目标位置是源代码在本地文件系统中的位置。

Answer 13

您如何提交更改？

从当前的本地*商业资源库调用此命令

hg commit [OPTION]... [FILE]...

别名：ci

• 本地Mercurial存储库在当前目录中具有.hg

选项可以是：

 -A --addremove     mark new/missing files as added/removed before committing
    --close-branch  mark a branch as closed, hiding it from the branch list
 -I --include       include names matching the given patterns
 -X --exclude       exclude names matching the given patterns
 -m --message       use <text> as commit message
 -l --logfile       read commit message from <file>
 -d --date          record datecode as commit date
 -u --user          record user as committer

一个示例命令是：

hg commit -m "added readme" README

注意事项 ：

• 如果省略文件列表，则将提交“ hg status”报告的所有更改。
• 如果要提交合并结果，请不要提供任何文件名或-I / -X过滤器。
• 如果未指定提交消息，则会启动配置的编辑器，提示您输入消息。

Answer 14

如何设置Mercurial？

Mercurial将其配置信息存储在* nix系统上的~/.hgrc和Windows系统上的%UserProfile%\\mercurial.ini中。 （在Windows 2000或Windows XP系统上， %UserProfile%通常是"C:\\Documents and Settings\\[username]\\" ，在Windows Vista和Windows 7系统上，通常是C:\\Users\\[username]\\ 。）

首先，您应该通过在.hgrc或mercurial.ini放置以下内容来设置Mercurial用户名：

# This is a Mercurial configuration file.
[ui]
username = Firstname Lastname <email.address@example.net>

Windows系统上的TortoiseHg用户也可以运行hgtk userconfig

另请参阅“ Mercurial：权威指南 ”的第2章中的 “ 创建Mercurial配置文件 ”。

Answer 15

您如何提交更改？

$ hg commit -m "Commit message"

Answer 16

您如何看待推送时将哪些更改发送到上游存储库？

使用hg outgoing获取将设置为默认存储库的变更集列表：

$ hg outgoing

要获得实际的代码更改，请使用-p （-- --patch ）。 这将完整输出每个变更集：

$ hg outgoing -p

Answer 17

您如何查看文件或存储库的修订历史？

显示整个存储库或文件的修订历史记录

$ hg log {file(s)}

要么

$ hg history {file(s)}

并以相反的顺序查看列表

$ hg log -r:

Answer 18

如何从存储库中删除文件？

要从存储库中删除文件，并在下次提交时将其删除：

$ hg remove {file(s)}

从存储库中删除文件但不删除它

$ hg remove -Af {file(s)}

或来自Mercurial 1.3

$ hg forget {file(s)}

Answer 19

您如何还原变更集？

几个选项可用

简单方法（撤消单个变更集）

$ hg backout -m 'back out second change' tip
reverting myfile
changeset 2:01adc4672142 backs out changeset 1:7e341ee3be7a
$ cat myfile
first change

困难的方式（手动比较和应用）

步骤1 ：创建补丁文件，以还原版本107和108之间的更改：

hg diff -r107 -r108 --reverse  > revert-change.patch

（或者，不带--reverse的hg diff -r108 -r107将执行相同的操作）

第2步 ：应用补丁文件：

patch -p1 < revert-change.patch

某些差异可能无法应用，例如：

Hunk #3 FAILED at 517.
1 out of 3 hunks FAILED -- saving rejects to file 'foo/bar.c.rej'

.rej文件将包含未能应用的diff的内容，您需要查看一下。

Answer 20

您如何返回到以前的代码版本？

从这个问题

$ hg update [-r REV]

@van：如果稍后提交，则将有效地创建一个新分支。 然后，您可能只继续在该分支上工作，或者最终将现有分支合并到该分支中。

Answer 21

您如何从特定变更集中提取补丁？

$ hg export -o patchfile changeset

然后可以使用以下命令将其导入另一个分支：

$ hg import patchfile

Answer 22

如何将一个分支的部分合并到另一个分支？

在.hg / hgrc中启用“ transplant”扩展名

[extensions]
transplant=

加载目标分支，然后移植目标修订。
例如：从分支'foo'樱桃修订版81到当前分支

$ hg transplant -b foo 81