Hg

Mercurial 是一种版本管理工具。将 Mercurial 安装完毕后可在命令行输入 hg (即为元素周期表中汞（Hydrargyrum）的元素符号 Hg) 作为调用程序的关键字。

常用命令

# 帮助
hg help

# 初始化
hg init

# 工作区文件改动状态
hg status

# 查看远程仓库地址
hg paths

# 查看日志
hg log

# 拉取代码 (未合并到本地)
hg pull

# 拉取代码 (自动更新到本地)
hg pull --update

# 拉取代码 (通过 rebase 的方式进行合并，需工作区没有未提交的文件)
# 若本地没有其他改动的代码，在 commit 前又忘记 pull --update, 可以使用该项命令避免产生冲突而生成新的无用 commit
hg pull --rebase

# 可以修改上次提交的 commit 的内容
#   ⚠️ WARNING: 由于 hg 不像 git 有缓存区，该操作会把当前还没有提交的 change 也一起提交上去，使用前应 hg shelve 保存草稿
hg commit --amend

回退

撤销上一次提交, 并将上一次提交的内容，放入待提交区

hg rollback

丢弃文件的修改

# 当前工作目录上有两个文件有改动
hg status
# M faas/README.md
# M faas/package.json
# (END)

# 丢弃 README.md 文件的改动，使其变回上一个版本的模样
hg revert faas-community/README.md

# 丢弃所有文件的修改，等价于 git reset --hard
hg revert -a

当执行某个操作修改了 commit 的信息后，hg 会自动做备份功能。例如:

hg strip commitId --keep

saved backup bundle to /Users/danny/project/project_a/.hg/strip-backup/commitId-xxx-backup.hg

当这时执行的效果不是你想要的话可以读取之前的自动备份:

hg unbundle /Users/danny/project/project_a/.hg/strip-backup/commitId-xxx-backup.hg
# 正在增加修改集
# 正在增加清单
# 正在增加文件改变
# 已增加 1 个修改集，包含 1 个改变，修改了 1 个文件 (+1 heads)
# new changesets commitId (1 drafts)
# (run 'hg heads' to see heads)

分支管理 (branch)

# 查看当前分支
hg branch

# 查看所有的分支
hg branches

# 切换到 feature_branch_name 分支中
hg checkout feature_branch_name

## 将 feature_branch_name_1 合并到当前分支上
$ hg merge "feature_branch_name_1"

日志 (log)

# 查看日志
hg log

# 按日期升序查看日志
hg log -r "sort(all(), date)"

# 显示分支图
hg log -G

# 查看上一个提交
hg parent

草稿 (shelve)

保存并搁置工作目录中的更改, 类似于 git stash

语法: hg shelve [OPTION]... [FILE]...

# 缓存当前工作区的改动
hg shelve

# 缓存当前工作区的改动并设置草稿的名字
hg shelve --name "draft_name"

# 展示当前项目的所有草稿
hg shelve --list
hg shelve -l

# 将缓存的改动恢复到工作区，后面加 name 可以恢复指定草稿，不加 name 则恢复最近的一个
hg unshelve
hg unshelve "draft_name"

# 删除指定草稿
hg shelve -d "draft_name"
hg shelve --delete "draft_name"

移植 (graft)

将其他分支的 commit 复制到当前分支中。

# 将 9393 的 commit 复制到当前分支中
# 相当于 git cherry-pick
hg graft -r 9393

# 将 9393 的 commit 复制到当前分支中，并修改提交信息
hg graft --edit 9393

Rebase (变基)

# 压缩最近两个 commit
hg rebase --dest .~2 --base . --collapse

# 当你在一个分支上进行一些提交并希望将它们全部折叠成一个时：
hg rebase --dest {destination branch (e.g. master)} --base . --collapse

Blame (annotate)

按行显示每个文件的变更集信息，可以用于追踪指定文件的每行代码是谁提交的、修改的 commit hash 是多少。

# -u 展示修改的作者是谁
# -c 展示修改集
# -l 展示行号
# file_path 为文件路径
hg blame -ucl <file_path>

Diff

# 查看当前版本与指定版本 (241290dffcea) 的差异
$ hg diff -r 241290dffcea

# diff 指定两个 commit 之间的差异
hg diff -r 241290dffcea -r da3019539240

# or, 可以直接使用指定序号
hg diff -r 102 -r 101

复合功能

我们可以根据历史记录来筛选出当前版本哪些文件被改动了，然后可以继续该版本进行筛选需要部署的文件。

hg status --change $(hg branch) $(hg root)/packages/faas/src/function/ | awk '{print $2}' | xargs -I {} basename {}

on-my-zsh

在 on-my-zsh 中使用 hg 的扩展: Mercurial plugin在新窗口打开

首先下载插件。

git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/mercurial

下载插件后编辑 ~/.zshrc 文件中的 plugins 字段，添加 mercurial:

plugins=(
  git
  yarn
  zsh-autosuggestions
  mercurial
)

若命令行处于 git 项目的目录下，则会在命令行显示当前分支，例如:

➜  front-end-lab git:(master) ✗

当 hg 不行，需要做额外的配置或选择支持 hg 的主题。zsh 可以通过 ZSH_THEME 变量切换主题，默认的主题为 robbyrussell。

zsh 主题文件都放在 ~/.oh-my-zsh/themes 目录下。笔者以默认主题为例，对默认的主题进行扩展:

# 通过 vim 修改
vim ~/.oh-my-zsh/themes/robbyrussell.zsh-theme

# 或者通过 vscode 修改的
code ~/.oh-my-zsh/themes/robbyrussell.zsh-theme

添加如下变量:

PROMPT+='$(hg_prompt_info)'

ZSH_THEME_HG_PROMPT_PREFIX="%{$fg_bold[blue]%}hg:(%{$fg[red]%}"
ZSH_THEME_HG_PROMPT_SUFFIX="%{$reset_color%}"
ZSH_THEME_HG_PROMPT_DIRTY="%{$fg[blue]%}) %{$fg[yellow]%}✗"
ZSH_THEME_HG_PROMPT_CLEAN="%{$fg[blue]%})"

再新开 zsh 后就能看到修改后的效果啦。

参考资料

Git hg rosetta stone在新窗口打开

# Hg

# 常用命令

# 回退

# 分支管理 (branch)

# 日志 (log)

# 草稿 (shelve)

# 移植 (graft)

# Rebase (变基)

# Blame (annotate)

# Diff

# 复合功能

# on-my-zsh

Hg