Mercurial 使用手册（零基础入门・命令行 + 实战）

Mercurial使用手册（零基础入门・命令行+实战）Mercurial（简称Hg）是一款分布式版本控制系统（DVCS），轻量、易用、跨平台（Windows/Linux/macOS），核心优势是分支管理灵活、学习成本低，广泛用于小型团队/个人项目。以下手册覆盖环境搭建、核心命令、分支/合并、协作、实战场景，新手可直接套用。一、环境搭建1.安装（跨平台）Linux：sudoaptinstallmercurial（Debian/Ubuntu）；sudoyuminstallmercurial（CentOS）macOS：brewinstallmercurial（需先装Homebrew）Windows：官网下载安装包（/），勾选“添加到PATH”2.验证安装bash运行hg--version显示版本号即安装成功3.基础配置（首次使用必做）bash运行配置全局用户名和邮箱（关联提交记录）hgconfig--globalui.username"YourName<your.email@>"查看配置hgconfig--list二、核心概念（先理解再操作）表格术语含义类比GitRepository(Repo)代码仓库（本地+远程）仓库WorkingDirectory工作目录（当前编辑的文件）工作区Commit提交（保存代码快照）提交Changeset变更集（每次提交生成唯一ID）提交记录Branch分支（默认default分支）分支Clone克隆（完整复制远程仓库）clonePull/Push拉取/推送（同步远程仓库）pull/pushMerge合并（合并分支变更）mergeUpdate更新（切换分支/恢复文件）checkout三、核心命令（高频使用・代码可直接复制）1.仓库初始化/克隆（1）本地新建仓库bash运行进入项目目录cd/path/to/your/project初始化仓库hginit此时生成.hg隐藏目录（仓库核心文件）（2）克隆远程仓库bash运行克隆公共仓库示例hgclone/repo/hg/克隆私有仓库（SSH）hgclonessh://user@server/path/to/repo2.代码提交（工作流核心）bash运行1.查看文件状态（必做：确认变更）hgstatus输出说明：M=修改过的文件A=新增的文件?=未跟踪的文件!=缺失的文件2.添加文件到跟踪（仅首次新增需要）hgaddfilename.py添加单个文件hgadd.添加所有未跟踪文件3.提交变更（必须写备注）hgcommit-m"新增用户登录功能：修复密码加密问题"提交后生成唯一ChangesetID（如1234567890ab）3.版本回溯/文件恢复bash运行查看提交历史（按时间倒序）hglog精简版：hglog--compacthglog-l5只看最近5条记录回溯到指定版本（保留工作目录变更）hgupdate<ChangesetID/版本号>示例：hgupdate1234567890ab或hgupdate-r5（第5个版本）恢复到最新版本hgupdatedefault放弃工作目录所有未提交变更（谨慎！）hgrevert--all恢复单个文件到最新提交状态hgrevertfilename.py4.分支管理（灵活是Hg核心优势）（1）创建/切换分支bash运行创建分支（如feature-login）hgbranchfeature-login提交后分支才生效hgcommit-m"创建登录功能分支"查看所有分支hgbranches切换分支hgupdatefeature-login（2）合并分支（完成功能后合并回主分支）bash运行1.先切换到主分支（default）hgupdatedefault2.合并feature-login分支hgmergefeature-login3.解决冲突（如有），然后提交合并结果hgcommit-m"合并登录功能分支到主分支"（可选）关闭已完成的分支hgupdatefeature-loginhgcommit--close-branch-m"关闭登录功能分支"5.远程仓库同步（协作必备）bash运行1.拉取远程最新变更（仅同步到本地仓库，不更新工作目录）hgpull2.更新工作目录到拉取的最新版本hgupdate3.推送本地变更到远程（需权限）hgpush推送指定分支：hgpush--branchfeature-login（可选）关联远程仓库（首次推送需配置）hgaddremotemyserverssh://user@server/path/to/repohgpushmyserver推送到指定远程6.其他高频命令bash运行对比变更（查看文件修改内容）hgdiff所有变更hgdifffilename.py单个文件标签（标记重要版本，如发布版）hgtagv1.0.0标记当前版本为v1.0.0hgtags查看所有标签忽略文件（创建.hgignore文件）echo"*.log\n__pycache__/\n*.pyc">.hgignorehgadd.hgignorehgcommit-m"添加忽略文件规则"四、实战场景（解决80%日常问题）场景1：误提交文件，需要撤销最后一次提交bash运行撤销最后一次提交（保留变更到工作目录）hgrollback注意：仅撤销未推送的提交，推送后不可用！场景2：解决合并冲突执行hgmerge后提示冲突，文件中会出现冲突标记：plaintext<<<<<<<local本地修改的内容=======远程/分支修改的内容>>>>>>>other手动编辑文件，删除冲突标记并调整代码；标记冲突已解决：hgresolve--markfilename.py；提交合并结果：hgcommit-m"解决登录功能合并冲突：统一密码加密逻辑"。场景3：本地分支推送到远程bash运行确保分支已提交，然后推送hgpush--new-branch--new-branch：推送本地新建的分支到远程场景4：查看某版本的具体修改内容bash运行hglog-p-r<ChangesetID>-p：显示补丁（修改内容）五、常见问题与排查表格问题现象原因解决方法hgpush提示权限拒绝无远程仓库写入权限检查SSH密钥/账号权限；联系仓库管理员hgstatus显示大量?文件文件未被跟踪用hgadd添加需要跟踪的文件，或在.hgignore中忽略无关文件合并后代码出错，想放弃合并未提交合并结果执行hgupdate-Cdefault（-C：强制回滚，放弃合并变更）hgupdate提示文件被修改工作目录有未提交变更先提交/暂存变更，或用hgupdate-C强制覆盖（谨慎）六、图形化工具（可选，简化操作）TortoiseHg：Windows/macOS图形化客户端，集成资源管理器右键菜单；HgWorkbench：Hg自带图形化工具，执行hgworkbench启动；优势：可视化分支/提交历史，点击操作替代命令行，适合新