Git Review是配合Gerrit代码审查工具使用的命令行客户端，能帮你把本地代码直接推送到Gerrit服务器进行评审。很多开发者第一次接触时，最头疼的就是环境配置和命令参数。这篇教程会从零开始，带你一步步完成安装、基础设置和日常提交，全程避开复杂术语，只讲实际操作。
安装前的环境检查
在安装之前，请确认你的电脑已经安装了Python 3.x版本，并且系统自带Git客户端。打开终端或命令行窗口，输入python --version和git --version查看版本信息。如果Python没有正确安装，请先去官网下载对应系统的安装包并完成环境变量配置。国内用户建议在终端中配置pip镜像源，比如清华源或阿里源，这样后续下载依赖包的速度会快很多。同时检查SSH服务是否正常运行，因为后续推送代码需要依赖加密通道。
通过pip快速安装
这是最常用的安装方式。在终端执行pip install git-review命令即可自动下载并安装最新版。如果遇到权限报错，可以加上sudo参数（Linux和macOS系统），或者使用虚拟环境来隔离依赖。安装完成后，输入git review --version验证是否成功。整个流程通常只需要几十秒，网络稳定时不会出现中断。
源码安装备用方案
如果你需要特定版本，或者公司内网无法访问外网，可以选择源码安装。先前往GitHub的官方仓库下载zip压缩包，解压后进入目录，执行python setup.py install命令。该方法对Python环境要求较严格，建议提前准备好setuptools和wheel等基础库。安装路径默认会在Python的site-packages目录下，可以通过locate git_review命令快速定位文件位置。
配置文件与远程绑定
安装成功后，必须完成基础配置才能正常使用。在项目的根目录下运行git review --init命令，系统会自动生成.gitreview配置文件。打开这个文件，填写gerrit地址、用户名和端口信息。gerrit地址通常是ssh://账号@域名/ip:端口号，记得替换成你们公司的实际地址。配置完成后，运行git review -s测试连接，显示Connection successful就说明通道已经打通。如果公司内部使用自定义协议，可以在config文件中追加protocol参数来适配。
日常提交与代码评审
写完代码并提交到本地分支后，执行git review命令即可将当前分支推送至Gerrit创建新的变更请求。如果需要指定目标分支，可以加上-b参数，例如git review -b develop。推送成功后，终端会返回一条Change-Id和评审链接，直接复制到浏览器即可查看初审界面。如果有多个评审任务，可以使用git review -l列出所有待处理的变更状态。日常开发中建议养成提交前先拉取最新主干的习惯，减少合并冲突的概率。
常见问题处理
遇到Permission denied时，多半是SSH密钥未添加或权限不足。请将公钥内容粘贴到Gerrit后台的SSH Keys页面，并确保私钥路径正确。如果提示找不到git_review命令，说明环境变量没有生效，可以尝试重新加载bash配置或重启终端。部分老旧项目可能依赖Python 2环境，此时需要在虚拟机或容器中单独部署兼容版本，避免污染主系统。网络超时问题可以尝试增加timeout参数或切换DNS解析节点。
掌握以上步骤后，Git Review就能顺畅融入你的开发工作流。坚持每次提交都带上规范的Commit Message，配合团队评审习惯，代码质量会有明显提升。遇到特殊报错时，优先查阅项目自带的README文档，大部分边界情况都能在里面找到对应解法。定期清理本地缓存的临时文件，也能让命令行操作保持流畅。
