用户指南

Size: px

Start display at page:

Download "用户指南"

桦邓
5 years ago
Views:

1 代码托管用户指南文档版本 11 发布日期华为技术有限公司

2 版权所有华为技术有限公司 2018 保留一切权利非经本公司书面许可, 任何单位和个人不得擅自摘抄复制本文档内容的部分或全部, 并不得以任何形式传播商标声明和其他华为商标均为华为技术有限公司的商标本文档提及的其他所有商标或注册商标, 由各自的所有人拥有注意您购买的产品服务或特性等应受华为公司商业合同和条款的约束, 本文档中描述的全部或部分产品服务或特性可能不在您的购买或使用范围之内除非合同另有约定, 华为公司对本文档内容不做任何明示或默示的声明或保证由于产品版本升级或其他原因, 本文档内容会不定期进行更新除非另有约定, 本文档仅作为使用指导, 本文档中的所有陈述信息和建议不构成任何明示或暗示的担保华为技术有限公司地址 : 深圳市龙岗区坂田华为总部办公楼邮编 : 网址 : 客户服务邮箱 : support@huawei.com 客户服务电话 : 文档版本 11 ( ) 版权所有华为技术有限公司 i

3 目录目录 1 前置准备 Git 客户端安装与配置快速上手系统管理员篇仓库成员管理仓库基本设置研发人员篇新建代码仓库设置 SSH 密钥 /HTTPS 密码客户端克隆 / 推送进阶操作导读代码评审流程新建合并请求仓库迁移将 SVN 代码库迁移到 Git 代码库将本地 Git 库上传到代码托管的代码仓库将代码托管的代码仓库 Clone 到本地 Git 库通过 EGit 插件导入远端工程 Eclipse 对接代码托管权限管理设置代码仓库成员使用 HTTPS 协议设置免密码提交代码部署密钥 SSH 密钥 /HTTPS 密码使用场景设置分支保护代码开发 Fork( 克隆 ) 代码仓库将提交的代码关联到工作项提交历史新建分支文档版本 11 ( ) 版权所有华为技术有限公司 ii

4 目录创建标签分支对比合并分支仓库网络仓库统计代码冲突代码冲突分析解决多人提交代码产生的冲突与覆盖仓库备份打包 ( 下载 ) 代码仓库代码广场创建公有代码仓库切换公有 / 私有代码仓库更多 Git 知识 Git 客户端使用 TortoiseGit 客户端使用 TortoiseGit 客户端生成 PPK 文件 TortoiseGit 客户端创建 Git 版本库 TortoiseGit 客户端 Clone 版本库 TortoiseGit 客户端 Push 版本库 Git 客户端示例 Git 客户端上传下载代码 Git 客户端设置 Windows 下的字符编码 Git 客户端修改文件名大小写后, 如何提交到远端 Git 客户端设置系统的换行符转换 Git 客户端提交中文名文件 Git 客户端提交隐藏文件 Git 客户端提交已被更改的文件 Git 常用命令 Git LFS 使用 Git 常见异常信息处理文档版本 11 ( ) 版权所有华为技术有限公司 iii

5 1 前置准备 1 前置准备 1.1 Git 客户端安装与配置 1.1 Git 客户端安装与配置 Windows - Git Bash 客户端使用代码托管需要用到 Git 客户端进行操作, 以下介绍常用客户端的安装与简易配置如果您熟悉常用的 Git 命令, 那么 Git Bash 将会是您 Windows 上最简洁最高效的客户端 1. 安装 2. 打开 a. 打开 Git Bash 官网下载链接根据您的系统位数下载 32 位 /64 位的安装包 b. 双击运行安装包, 在弹出的安装窗口中一路单击下一步 (Next), 最后单击安装 (Install) 即可完成,Git Bash 客户端将会安装在默认的 C: \Program Files\Git 位置单击 Windows 开始图标, 在开始搜索栏中输入 Git Bash, 单击回车即可打开 Git Bash 客户端, 建议将其固定到 Windows 的任务栏中 3. 配置 a. 第一步需要您配置用户名和邮箱, 在 Git Bash 中输入以下命令行 : git config --global user.name "< 您的用户名 >" git config --global user. "< 您的邮箱 >" b. 第二步需要您生成一对 SSH 密钥, 用来和代码托管服务端进行鉴权认证, 在 Git Bash 中输入以下命令行 : ssh-keygen -t rsa -C "< 您的邮箱 >" 然后输入 3 个回车 (Enter 键 ) 即可, 生成的 SSH 秘钥对默认在 ~/.ssh/id_rsa ~/.ssh/id_rsa.pub 位置到这里您已经安装好 Git Bash 客户端了, 到快速上手一探究竟吧! 文档版本 11 ( ) 版权所有华为技术有限公司 1

1 前置准备 Windows - TortoiseGit 客户端如果您未熟悉常用的 Git 命令, 或者是从熟悉的 SVN 客户端 (TortoiseSVN) 迁移过来的, 那么 TortoiseGit 客户端将是您最佳的选择 Git 中的 TortoiseGit 客户端相当于 SVN 中的 TortoiseSVN 户端 1.

6 1 前置准备 Windows - TortoiseGit 客户端如果您未熟悉常用的 Git 命令, 或者是从熟悉的 SVN 客户端 (TortoiseSVN) 迁移过来的, 那么 TortoiseGit 客户端将是您最佳的选择 Git 中的 TortoiseGit 客户端相当于 SVN 中的 TortoiseSVN 户端 1. 前置条件 TortoiseGit 是基于 Git 的客户端, 需要先安装好 Git 客户端才能运行, 请直接参照上一步 Windows - Git Bash 客户端进行安装 2. 安装与第一次启动 a. 打开 TortoiseGit 官网下载链接, 根据您的系统位数下载 32 位 /64 位的安装包 b. 双击运行安装包, 在弹出的窗口中一路单击 Next, 然后单击 Install 即可完成安装, 最后单击 Finish 即会运行第一次启动引导 c. 在弹出的第一次启动引导中, 会有 Language 语言选择 Git 可执行路径配置 ( 自动填充可用的 Git 路径 ) 配置用户名和邮箱, 保持默认一路单击 Next 完成即可 3. 中文化 ( 可选, 推荐使用 ) a. TortoiseGit 的安装包默认为英文, 可以从 TortoiseGit 官网下载链接下载语言包 (Language Packs), 这里选择 Chinese simplified 语言包, 下载对应的 32 位 /64 位的语言包然后双击运行, 在完成之前勾选 Configure TortoiseGit to use this language 即可完成汉化, 如图 1-1 所示图 1-1 中文化 4. 配置 TortoiseGit 同样需要一个密钥来和代码托管服务端进行鉴权认证, 并且需要基于 Git 的 SSH 密钥对来生成 ( 即 Git Bash 客户端 - 配置中生成的 ~/.ssh/id_rsa ~/.ssh/id_rsa.pub ),TortoiseGit 密钥生成步骤如下 : 文档版本 11 ( ) 版权所有华为技术有限公司 2

ppk 格式 ), 单击 Save private key 然后在弹出的窗口中输入文件名保存, 如图 1-3 所示图 1-3 保存文件 Linux - Git 客户端到这里您已经安装好 TortoiseGit 客户端了, 到快速上手一探究竟吧! 1. Debian/Ubuntu 系统在终端中输入以下命令行安装 : apt-get install git 2.

7 1 前置准备 a. 单击 Windows 开始图标搜索 PuttyGen 并打开, 在打开的窗口中单击 Load 按钮, 选择文件类型为 All Files(*.*), 然后在打开的 ~/.ssh 目录下选择 id_rsa 文件, 如图 1-2 所示图 1-2 选择 id_rsa 文件 b. 选择好 SSH 密钥文件 (~/.ssh/id_rsa) 后, 就可以生成 TortoiseGit 的密钥文件了 (.ppk 格式 ), 单击 Save private key 然后在弹出的窗口中输入文件名保存, 如图 1-3 所示图 1-3 保存文件 Linux - Git 客户端到这里您已经安装好 TortoiseGit 客户端了, 到快速上手一探究竟吧! 1. Debian/Ubuntu 系统在终端中输入以下命令行安装 : apt-get install git 2. Fedora/Centos 系统在终端中输入以下命令行安装 : yum install git 3. 更多操作系统请参见官网链接 Download for Linux and Unix 文档版本 11 ( ) 版权所有华为技术有限公司 3

8 1 前置准备 Mac - Git 客户端 Mac 上安装 Git 最简单的方法是安装 Xcode Command Line Tools,Mavericks(10.9) 或更高版本的系统中, 在 Terminal 里尝试首次运行 git 命令即可如果没有安装过命令行开发者工具, 将会提示您安装如果您想安装更新的版本, 可以使用二进制安装程序, 官方维护的 OSX Git 安装程序可以在 Git 官方网站下载, 网址为文档版本 11 ( ) 版权所有华为技术有限公司 4

2 快速上手 2 快速上手 2.1 系统管理员篇 2.2 研发人员篇 2.1 系统管理员篇 2.1.1 仓库成员管理添加仓库成员 1.

10 2 快速上手说明选择您想添加的用户进行添加即可, 如果您还没有子用户, 可单击右上角的创建用户, 然后按指引创建 2. 用户已添加到项目中后, 进入仓库添加成员 : 选择项目左侧导航代码 > 代码托管菜单, 搜索仓库, 然后单击操作一栏的成员按钮, 如图 2-2 所示图 2-2 仓库成员 3. 在仓库的成员管理页面, 勾选对应的用户, 单击确定即可添加用户到仓库成员中, 如图 2-3 所示图 2-3 添加仓库成员文档版本 11 ( ) 版权所有华为技术有限公司 6

2 快速上手删除仓库成员在仓库成员管理页面单击对应用户的移出成员按钮即可删除仓库成员, 如图 2-4 所示图 2-4 删除仓库成员 2.1.

13 2 快速上手 2. 选择普通新建, 填写好仓库名与对应的项目, 单击确认即可新建, 如图 2-8 所示图 2-8 普通新建 3. 在新建跳转后的代码托管首页可看到仓库列表, 随即会创建成功, 如图 2-9 所示图 2-9 仓库列表到这里您已经新建了一个仓库, 去设置您的 SSH 密钥 /HTTPS 密码吧! 设置 SSH 密钥 /HTTPS 密码设置 SSH 密钥后续需要在本地客户端进行代码仓库的克隆 / 推送,SSH 秘钥和 HTTPS 密码是客户端和服务端交互的凭证, 需要先对它们进行设置 SSH 密钥是使用 SSH 协议和代码托管服务端交互的凭证, 如果您使用 windows 下的 Git Bash 客户端并在 Windows - Git Bash 客户端中已经生成, 此步骤可以略过 1. 打开 Git 客户端 (Git Bash 或 linux 的命令行窗口 ), 输入以下命令行 : ssh-keygen -t rsa -C "< 您的邮箱 >" 然后输入 3 个回车 (Enter 键 ) 即可, 生成的 SSH 秘钥对默认在 ~/.ssh/id_rsa ~/.ssh/ id_rsa.pub 位置, 如图 2-10 所示文档版本 11 ( ) 版权所有华为技术有限公司 9

复制上述的 SSH 密钥内容, 去到代码托管首页, 单击设置我的 SSH 密钥按钮去到 SSH 密钥管理页面, 单击添加 SSH 密钥进行添加 i.

14 2 快速上手图 2-10 生成 SSH 秘钥 2. 添加 SSH 密钥到代码托管服务端 a. 打开 Git 客户端 (Git Bash 或 linux 的命令行窗口 ), 将 SSH 密钥 (~/.ssh/ id_rsa.pub) 的内容打印出来, 如图 2-11 所示 cat ~/.ssh/id_rsa.pub 图 2-11 添加 SSH 密钥 b. 复制上述的 SSH 密钥内容, 去到代码托管首页, 单击设置我的 SSH 密钥按钮去到 SSH 密钥管理页面, 单击添加 SSH 密钥进行添加 i. 进入 SSH 密钥管理页面, 如图 2-12 所示图 2-12 SSH 密钥管理页面 ii. 单击添加 SSH 密钥按钮进行添加, 粘贴上述复制的 SSH 密钥内容, 单击新建即可, 如图 2-13 所示文档版本 11 ( ) 版权所有华为技术有限公司 10

15 2 快速上手图 2-13 新建 SSH 密钥至此, 您已经设置好了 SSH 密钥, 您可以继续设置 HTTPS 密码, 或到客户端克隆 / 推送设置 HTTPS 密码 HTTPS 密码是使用 HTTPS 协议和代码托管服务端交互的凭证, 设置步骤如下 : 1. 进入代码托管首页, 单击设置我的 HTTPS 密钥, 显示 HTTPS 密钥管理页面 a. 如果您是第一次进行设置, 则输入 2 次 HTTPS 密码保存即可, 如图 2-14 所示文档版本 11 ( ) 版权所有华为技术有限公司 11

2 快速上手 2.2.3 客户端克隆 / 推送前提条件背景信息到这里您已经设置好了 HTTPS 密码, 去客户端克隆 / 推送一个仓库吧!

17 2 快速上手客户端克隆 / 推送前提条件背景信息到这里您已经设置好了 HTTPS 密码, 去客户端克隆 / 推送一个仓库吧! 请先确保您已正确设置了 SSH 密钥或 HTTPS 密码, 请参见设置 SSH 密钥 /HTTPS 密码除页面操作外, 代码仓库的克隆 / 拉取 / 推送等操作都是在 Git 客户端完成的下面就在 Git 客户端进行一次克隆 / 推送操作, 其中包括克隆仓库新建一个分支新建一个文件提交推送仓库使用 SSH 协议 :Windows - Git Bash 客户端 1. 克隆仓库 a. 进入代码托管首页, 单击仓库列表中的仓库名去到仓库详情页, 复制访问方式中的 SSH 链接, 如图 2-16 所示图 2-16 复制 SSH 访问链接 b. 打开 Git Bash 客户端去到您的目录下, 输入以下命令即可把仓库克隆下来, 如图 2-17 所示 git clone < 您仓库的 SSH 下载链接 > 图 2-17 仓库克隆 2. 新建一个分支进入到代码仓库目录, 使用以下命令行新建一个新的分支, 如图 2-18 所示 git checkout -b < 您的分支名 > 文档版本 11 ( ) 版权所有华为技术有限公司 13

18 2 快速上手图 2-18 新建分支 3. 新建一个文件使用以下命令行新建一个文件, 如图 2-19 所示 echo "Welcome to DevCloud!" > newfile.txt 图 2-19 新建文件 4. 提交 a. 以上两步新建了一个分支和一个文件, 输入以下命令行查看当前仓库状态, 如图 2-20 所示 git status 图 2-20 查看仓库状态 b. 将新增的文件添加到 Git 工作区, 并对本次的修改进行一次提交, 如图 2-21 所示 git add newfile.txt git commit -m "< 您对本次提交备注的信息 >" 文档版本 11 ( ) 版权所有华为技术有限公司 14

19 2 快速上手图 2-21 提交 5. 推送仓库 a. 以上已经在新分支上进行了一次新的提交, 现在可以把所做的更改推送到服务端, 如图 2-22 所示 git push origin < 您的分支名 > 图 2-22 推送仓库到这里您已经完成了在客户端克隆推送的操作, 恭喜您完成了快速上手教程! 使用 SSH 协议 :Windows - TortoiseGit 客户端 1. 克隆仓库 a. 进入代码托管首页, 单击仓库列表中的仓库名去到仓库详情页, 复制访问方式中的 SSH 链接, 如图 2-23 所示图 2-23 复制 SSH 访问链接文档版本 11 ( ) 版权所有华为技术有限公司 15

2 快速上手图 2-27 克隆日志 2. 新建一个文件并提交到新分支 a. 进入仓库目录, 新建一个 newfile.

2 快速上手图 2-33 推送日志使用 SSH 协议 :Linux/Mac 到这里您已经完成了在客户端克隆推送的操作, 恭喜您完成了快速上手教程! Linux/Mac 上 Git 客户端的克隆操作和 Windows - Git Bash 客户端的操作完全一样使用 HTTPS 协议 :Windows - Git Bash 客户端 1. 克隆仓库 a.

27 2 快速上手图 2-33 推送日志使用 SSH 协议 :Linux/Mac 到这里您已经完成了在客户端克隆推送的操作, 恭喜您完成了快速上手教程! Linux/Mac 上 Git 客户端的克隆操作和 Windows - Git Bash 客户端的操作完全一样使用 HTTPS 协议 :Windows - Git Bash 客户端 1. 克隆仓库 a. 进入代码托管首页, 单击仓库列表中的仓库名去到仓库详情页, 复制访问方式中的 HTTPS 链接, 如图 2-34 所示图 2-34 复制 HTTPS 访问链接 b. 打开 Git Bash 客户端进入您的目录下, 输入以下命令进行仓库克隆, 其中第一次克隆需要您填写用户名 ( 账号名 / 用户名 ) 和 HTTPS 密码, 如图 2-35 所示文档版本 11 ( ) 版权所有华为技术有限公司 23

28 2 快速上手 git clone < 您的 HTTPS 下载链接 > 图 2-35 克隆仓库 2. 新建一个分支进入到代码仓库目录, 使用以下命令行新建一个新的分支, 如图 2-36 所示 git checkout -b < 您的分支名 > 图 2-36 新建分支 3. 新建一个文件使用以下命令行新建一个文件, 如图 2-37 所示 echo "Welcome to DevCloud!" > newfile.txt 文档版本 11 ( ) 版权所有华为技术有限公司 24

29 2 快速上手图 2-37 新建文件 4. 提交 a. 以上两步新建了一个分支和一个文件, 输入以下命令行查看当前仓库状态, 如图 2-38 所示 git status 图 2-38 提交 b. 将新增的文件添加到 Git 工作区, 并对本次的修改进行一次提交, 如图 2-39 所示 git add newfile.txt git commit -m "< 您对本次提交备注的信息 >" 图 2-39 提交文件 5. 推送仓库以上已经在新分支上进行了一次新的提交, 现在可以把所做的更改推送到服务端, 如图 2-40 所示文档版本 11 ( ) 版权所有华为技术有限公司 25

30 2 快速上手 git push origin < 您的分支名 > 图 2-40 推送仓库到这里您已经完成了在客户端克隆推送的操作, 恭喜您完成了快速上手教程! 使用 HTTPS 协议 :Windows - TortoiseGit 客户端克隆仓库 1. 进入代码托管首页, 单击仓库列表中的仓库名去到仓库详情页, 复制访问方式中的 HTTPS 链接, 如图 2-41 所示图 2-41 复制 HTTPS 访问链接 2. 进入您的目录下, 右键在弹出的菜单选项中选择 Git 克隆, 如图 2-42 所示文档版本 11 ( ) 版权所有华为技术有限公司 26

客户端会要求您输入用户名和 HTTPS 密码, 如图 2-44 所示图 2-44

2 快速上手图 2-45 克隆日志 3. 新建一个文件并提交到新分支 a. 进入仓库目录, 新建一个 newfile.

2 快速上手图 2-48 提交 4. 推送仓库经过以上步骤已经在一个新的分支上添加了一个文件, 现在可以将本次更改推送到代码托管服务端 a.

2 快速上手图 2-51 推送日志使用 HTTPS 协议 :Linux/Mac 到这里您已经完成了在客户端克隆推送的操作, 恭喜您完成了快速上手教程

40 3 进阶操作 3 进阶操作 3.1 导读 3.2 代码评审 3.3 仓库迁移 3.4 权限管理 3.5 代码开发 3.6 代码冲突 3.7 仓库备份 3.8 代码广场 3.1 导读进阶操作主要包括 : 代码评审仓库迁移权限管理代码开发代码冲突仓库备份代码广场相关的高级操作 3.2 代码评审流程代码托管的主干维护分支开发的流程如图 3-1 所示文档版本 11 ( ) 版权所有华为技术有限公司 36

42 3 进阶操作操作步骤 1. 进入代码仓库详情页面 2. 单击左侧导航区合并请求, 进入合并请求页面 3. 单击新建合并请求, 进入新建合并请求页面, 如图 3-2 所示图 3-2 新建合并请求 4. 选择分支后, 单击下一步, 根据提示完成合并 5. ( 可选 ) 进入合并请求详情页, 显示评论记录, 如图 3-3 所示图 3-3 评论记录 6. 单击, 显示评论所在的代码行, 如图 3-4 所示图 3-4 评论所在代码行 3.3 仓库迁移文档版本 11 ( ) 版权所有华为技术有限公司 38

43 3 进阶操作将 SVN 代码库迁移到 Git 代码库背景信息代码托管服务提供基于 Git 的分布式版本控制管理服务, 能够更加便捷的进行异地协作虽然不支持 SVN 库, 但可以将 SVN 代码库转换为 Git 仓库迁移到 DevCloud 中操作步骤步骤 1 查看 SVN 路径下需要转换的库或目录例如 : no-metadata trunk=trunk test 说明 no metadata: 阻止 Git 导出 SVN 包含的附加信息, 使提交到 Git 的记录很干净 trunk: 主分支 test: 创建的 Git 项目名称步骤 2 在本地新建文件夹, 用于存放转换后的 SVN 库 cmd 模式 mkdir E:\devcloud\test\svn\ cd E:\devcloud\test\svn\ bash 模式 mkdir -p E:/devcloud/test/svn/ cd E:/devcloud/test/svn/ 步骤 3 克隆 SVN 代码使用 git-svn 转换工具将 SVN 转换成 Git 库 : git svn clone " no-metadata trunk=trunk test" 说明路径中如果有空格使用执行过程可能会提示输入 SVN 帐户, 根据提示输入用户名和密码文件夹下如果存在.git 文件夹, 说明本地库转换成功, 可以使用 git log 查看记录步骤 4 新建 DevCloud 代码仓库, 并关联云仓库中即选择要提交的代码仓库, 将本地的代码库添加到远端库 : git remote add origin git@gitlab.xxx.com:first/test.git 说明 git@gitlab.xxx.com:first/test.git 为云仓库地址步骤 5 将 SVN 代码库同步到云仓库中 1. 拉取远端的代码到本地 : git pull origin master //origin: 起源 2. 推送代码到远端 : git push origin master //master: 主分支 ---- 结束文档版本 11 ( ) 版权所有华为技术有限公司 39

44 3 进阶操作将本地 Git 库上传到代码托管的代码仓库背景信息操作步骤在本地 Git 上开发好代码后, 可以上传到云端代码托管的代码仓库 (Git 仓库 ) 步骤 1 在代码托管中新建代码仓库 Repo1 步骤 2 步骤 3 步骤 4 步骤 5 步骤 6 将本地的仓库目录变为 Git 仓库 $ git init 进入本地仓库目录选择要提交的代码仓库将本地仓库添加到远端仓库 $ git remote add origin git@devcloud.huawei.com:testtransfer/repo1.git 拉取远端的代码到本地 $ git pull origin master 推送全部代码到远端仓库 $ git push origin master ---- 结束将代码托管的代码仓库 Clone 到本地 Git 库背景信息在 DevCloud 代码托管中创建好代码仓库后, 开发人员可以把云端代码克隆到本地使用操作步骤 1. 确认密钥成功配置 ( SSH 或 HTTPS 类型 ) 2. 选择目标代码仓库 3. 复制代码仓库地址 ( SSH 或 HTTPS 类型 ) 进行 Clone bash 模式 git clone + 地址客户端模式 i. 鼠标右键, 单击 Git Clone, 如图 3-5 所示文档版本 11 ( ) 版权所有华为技术有限公司 40

3 进阶操作图 3-6 Clone 代码库 3.3.4 通过 EGit 插件导入远端工程 1.

3 进阶操作图 3-8 Import Projects from Git Source Git Repository 说明 URI: git@codehub-rnd-devcloud.huawei.com:gitlab/gitlabtests.

3 进阶操作图 3-11 Select a wizard to use for importing projects 说明 3.3.5 Eclipse 对接代码托管背景信息前面步骤 1~4 相当于拉取远端库到本地, 可以在本地选择的目录看到下载的项目如果 Git 库上没有工程文件, 需要选择 Use the New Project wizard ( 新建项目方式 ), 需要实际项目

51 3 进阶操作图 3-11 Select a wizard to use for importing projects 说明 Eclipse 对接代码托管背景信息前面步骤 1~4 相当于拉取远端库到本地, 可以在本地选择的目录看到下载的项目如果 Git 库上没有工程文件, 需要选择 Use the New Project wizard ( 新建项目方式 ), 需要实际项目 maven java web 等类型导入相应类型的项目 Eclipse 安装 Git 插件 EGit 后, 可以完全对接代码托管, 如将本地 Git 仓库代码完整提交到远程 Git 仓库中说明 Eclipse 4.4 版本已天然支持 Git 插件 ( 在 Eclipse3.3 版本没有自带 EGit 插件, 无法安装 ) 步骤一 : 在 Eclipse 上安装 Git 插件 EGit 以 Eclipse 的版本 eclipse-java-helios-sr2-win32.zip 为例, 具体操作如下 : 文档版本 11 ( ) 版权所有华为技术有限公司 47

3 进阶操作 1. 在 Eclipse 上方工具栏选择 Help > Install New Software... 菜单, 如图 3-12 所示图 3-12 Install New Software 2.

53 3 进阶操作图 3-13 Add Site 3. 单击 OK 按钮, 随后连续下一步默认安装即可安装完成后重启 Eclipse 步骤二 : 在 Eclipse 中配置 EGit 1. 在 Eclipse 上方工具栏选择 Window > Preferences > Team > Git > Configuration, 如图 3-14 所示 user.name 为已注册的用户名文档版本 11 ( ) 版权所有华为技术有限公司 49

54 3 进阶操作图 3-14 Add a Configuration Entry 2. 单击 OK, 如图 3-15 所示 user. 为已绑定的邮箱在这里配置 user.name 即可图 3-15 Configuration 步骤三 : 新建项目, 并将代码提交到本地的 Git 仓库中 1. 新建项目 git_demo, 并新建 HelloWorld.java 类, 如图 3-16 所示文档版本 11 ( ) 版权所有华为技术有限公司 50

56 3 进阶操作 3. 在弹出的 Share Project 窗口中, 选中 Git, 如图 3-18 所示图 3-18 Share Project 4. 单击 Next, 弹出 Configure Git Repository, 如图 3-19 所示图 3-19 Configure Git Repository 5. 单击 Create Repository, 成功创建 Git 仓库文件夹此时处于 untracked 状态 ( 文件夹中的符号? 表示 ) 此时需要提交代码到本地仓库, 如图 3-20 所示开始提交文档版本 11 ( ) 版权所有华为技术有限公司 52

59 3 进阶操作图 3-22 Commit 步骤四 : 将本地仓库代码提交到远程的 Git 仓库中 1. 在 DevCloud 的代码托管中创建仓库创建好远程仓库后, 进入远程代码仓库详情页面, 可以单击址 2. 选择 Push 菜单, 开始将代码提交到远程仓库, 如图 3-23 所示复制远程仓库地图 3-23 Push 菜单 3. 在弹出的 Push to Another Repository 窗口中, 设置相应参数, 如图 3-24 所示文档版本 11 ( ) 版权所有华为技术有限公司 55

3 进阶操作图 3-24 Push to Another Repository 4.

3 进阶操作图 3-28 提交本地代码 8. 单击 OK, 完成代码提交远程仓库登录远程仓库地址 ( 如 https://codehub.devcloud.hwclouds.com/wenchao523/ git_demo ) 核对提交的代码说明如果是首次提交 : 1. 第一步 : 先在本地建立一个一样的仓库, 称本地仓库 2.

64 3 进阶操作图 3-28 提交本地代码 8. 单击 OK, 完成代码提交远程仓库登录远程仓库地址 ( 如 git_demo ) 核对提交的代码说明如果是首次提交 : 1. 第一步 : 先在本地建立一个一样的仓库, 称本地仓库 2. 第二步 : 在本地进行 Commit, 将更新提交到本地仓库 3. 第三步 : 将服务器端的更新 Pull 到本地仓库进行合并, 最后将合并好的本地仓库 Push 到服务器端, 即进行一次远程提交如果非首次提交 : 1. 第一步 : 将修改的代码 Commit 更新到本地仓库 2. 第二 / 三步 : 将服务器端的更新 Pull 到本地仓库进行合并, 最后将合并好的本地仓库 Push 到服务器端 3.4 权限管理设置代码仓库成员前提条件背景信息项目创建者项目经理和仓库管理员可以设置成员为仓库管理员用户创建了项目并添加了项目成员后, 为了保证代码的安全, 还需要在代码托管中添加代码仓库的成员, 即将项目成员设置为代码仓库成员, 才能访问代码仓库 ; 否则, 非仓库成员将不能访问代码仓库文档版本 11 ( ) 版权所有华为技术有限公司 60

65 3 进阶操作仓库成员添加完成后, 还可以根据需要给仓库成员设置不同角色权限操作步骤步骤 1 在代码托管首页搜索需要添加成员的代码仓库 ( 以 CodeHub01 为例 ) 步骤 2 单击代码仓库 ( 如 CodeHub01 ) 所在行进入成员管理页面, 如图 3-29 所示图 3-29 成员管理说明项目创建者和项目经理默认是代码仓库的管理员, 可以通过变更其在项目中的角色来修改其在代码仓库中的角色成员管理列表中的成员即为仓库所属项目的项目经理及开发人员开发人员可以被设置为仓库普通成员或仓库管理员步骤 3 单击添加成员在添加成员窗口中选择项目成员, 并单击确定, 即可完成代码仓库成员的添加步骤 4 ( 可选 ) 成员管理区域, 根据需要设置开发人员为普通成员仓库管理员移出成员或添加成员单击设置为普通成员单击设置为仓库管理员单击移出成员 ---- 结束使用 HTTPS 协议设置免密码提交代码前提条件使用 HTTPS 协议访问代码仓库, 需要设置 SSH 密钥 /HTTPS 密码使用 HTTPS 协议方式在进行 Git clone Git fetch Git pull 以及 Git push 等操作时, 需要输入 DevCloud 中 CodeHub 的用户名和密码文档版本 11 ( ) 版权所有华为技术有限公司 61

66 3 进阶操作背景信息为避免每次访问都输入用户名和密码, 可以使用 Git 的凭证存储功能实现免密码访问 ( 为保证该功能正常使用, 建议安装 Git2.5 以上版本 ), 三种操作系统的设置方法如下 : Windows 系统 : 使用 HTTPS 协议设置免密码提交代码 MAC 系统 : 使用 HTTPS 协议设置免密码提交代码 Linux 系统 : 使用 HTTPS 协议设置免密码提交代码 Windows 系统如何使用 HTTPS 协议设置免密码提交代码 Windows 系统设置免密码提交代码有两种方法, 如表 3-1 所示表 3-1 Windows 系统设置免密码提交代码方法本地配置 HTTPS 密码安装 winstore 辅助工具实现免密码访问操作说明 1. 设置 Git 验证方式打开 Git 客户端 :$ git config --global credential.helper store 2. 创建.git-credentials 文件在客户端输入命令 :$ touch ~/.git-credentials 3. 配置用户名和密码 4. 使用 Git 命令进行首次 Clone 或 Push 代码, 根据提示填写用户名和密码 5. 打开.git-credentials 文件, 如果已在本地存储了用户名和密码, 出现如下记录 : winstore 辅助工具使用 Windows Credential Store 控制敏感信息, 请到下载如果安装结束后弹出如图 3-30 所示对话框, 请将 Git 的安装路径添加到 path 环境变量中图 3-30 Git Credentials MAC 系统如何使用 HTTPS 协议设置免密码提交代码安装 osxkeychain 工具来实现免密码访问 : 文档版本 11 ( ) 版权所有华为技术有限公司 62

67 3 进阶操作 1. 查找当前系统是否已经安装该工具 : $ git credential -osxkeychain # Test for the cred helper Usage: git credential -osxkeychain < get store erase > 2. 如果该工具未安装, 先获取安装包 : $ git credential -osxkeychain # Test for the cred helper git: 'credential -osxkeychain' is not a git command. See 'git --help'. $ curl -s -o \ # Download the helper $ chmod u+x git-credential-osxkeychain # Fix the permissions on the file so it can be run 3. 将 osxkeychain 安装在 Git 的同一个目录下 : $ sudo mv git-credential-osxkeychain\ "$(dirname $(which git))/git-credential-osxkeychain" # Move the helper to the path where git is installed Password:[enter your password] 4. 使用 osxkeychain 工具将 Git 配置成免密码模式 : $git config --global credential.helper osxkeychain #Set git to use the osxkeychain credential helper 说明第一次执行操作时会提示输入密码, 输入后将由 osxkeychain 管理用户名和密码, 后续再执行 Git 操作时将不再需要密码校验 Linux 系统如何使用 HTTPS 协议设置免密码提交代码后续处理 Linux 系统提供两种可选的免密码访问模式 : cache 模式 : 将凭证存放在内存中一段时间, 密码永远不会被存储在磁盘中, 并且在 15 分钟后从内存中清除 : $ git config --global credential.helper cache #Set git to use the credential memory cache 通过 timeout 选项设置过期时间, 单位为秒 : $ git config --global credential.helper 'cache --timeout=3600' # Set the cache to timeout after 1 hour (setting is in seconds) store 模式 : 将凭证用明文的形式存放在磁盘 home 目录下 ( 默认是 ~/.gitcredentials ), 永不过期, 除非手动修改在 Git 服务器上的密码, 否则永远不需要再次输入凭证信息 git-credentials 文件内容如下 : 保存退出后, 执行如下命令即可完成 : # git config --global credential.helper store 如果在使用 HTTPS 协议下载时提示 SSL certificate problem: self signed certificate 错误信息, 请在客户端进行如下设置 : git config --global http.sslverify false 文档版本 11 ( ) 版权所有华为技术有限公司 63

68 3 进阶操作部署密钥前提条件仓库部署密钥对仓库仅具有只读权限部署密钥不能与用户密钥重复不同仓库可以添加相同部署密钥, 同一个仓库部署密钥不允许重复每个仓库最多只能部署 10 个密钥背景信息部署密钥用于编译构建或发布设置部署密钥后, 在编译构建中可以通过该密钥自动获取仓库代码操作步骤 1. 进入代码仓库详情页面 2. 单击左侧导航区设置 > 部署密钥, 进入已部署密钥列表页面 3. 单击设置部署密钥, 弹出设置部署密钥页面, 如图 3-31 所示图 3-31 设置部署密钥 SSH 密钥 /HTTPS 密码使用场景 SSH 密钥 /HTTPS 密码的使用场景主要有三种, 如表 3-2 所示文档版本 11 ( ) 版权所有华为技术有限公司 64

69 3 进阶操作表 3-2 SSH 密钥 /HTTPS 密码使用场景场景如何使用 SSH 密钥和 HTTPS 密码上传下载代码使用说明 SSH 和 HTTPS 是使用 Git 进行代码版本管理的两种连接方式 : 选择 SSH 方式, 需要代码托管中提示生成密钥并添加到系统中选择 HTTPS 方式, 可通过 DevCloud 生成密码, 直接在代码托管中获取 HTTPS 密码即可说明使用其中任何一种方式都可以进行代码的上传下载, 密钥 ( 密码 ) 的设置根据您选择的连接方式设定即可代码仓库地址可在仓库详情页面, 单击即可复制仓库地址如何使用 SSH 密钥建立每个仓库的连接代码仓库添加了 SSH 密钥后, 如何使用该密钥上传下载代码 SSH 密钥是在电脑与某个帐号下的代码托管服务之间建立安全连接, 在一台电脑上配置了 SSH 密钥并添加公钥到代码托管服务中后, 所有该帐号下的代码仓库与该台电脑之间都可以使用该密钥进行连接例如 : 我创建了三个代码仓库, 就不需要为每个仓库都创建一个 SSH 密钥 SSH 密钥在电脑和代码托管服务之间建立安全连接, 不同的用户通常使用不同的电脑, 在使用 SSH 方式连接代码仓库前需要在自己电脑配置各自的 SSH 密钥例如 : 我创建了一个代码仓库并添加了 SSH 密钥, 就只能我自己使用该密钥上传下载代码 ; 其他用户则不能使用该密钥上传下载代码设置分支保护背景信息通过对分支设置保护, 可以保证安全性信息 ; 并根据实际需要可以解除分支保护操作步骤 1. 进入代码仓库详情页面 2. 单击左侧导航区设置 > 分支保护, 进入已保护分支列表页面, 如图 3-32 所示图 3-32 已保护分支列表文档版本 11 ( ) 版权所有华为技术有限公司 65

70 3 进阶操作 3. 单击保护分支所在行, 可以设置是否保护分支, 如图 3-33 所示图 3-33 编辑保护分支后续处理可以根据实际需要解除分支保护 : 1. 单击保护分支所在行 2. 根据提示信息单击确定, 解除对该分支的保护 3.5 代码开发 Fork( 克隆 ) 代码仓库背景信息操作步骤在代码托管中, 可以直接 Fork 已有代码仓库步骤 1 登录代码托管首页步骤 2 单击代码仓库所在行进入 Fork 代码仓库页面, 如图 3-34 所示文档版本 11 ( ) 版权所有华为技术有限公司 66

71 3 进阶操作图 3-34 Fork( 复制 ) 代码仓库步骤 3 设置项目名与仓库名后, 单击确定, 可以 Fork 代码仓库, 即复制代码仓库说明 ---- 结束复制代码仓库完成后, 请根据需要设置代码仓库成员将提交的代码关联到工作项背景信息在代码托管中, 提交代码时, 可以实现代码与工作项的关联关联成功后, 可以根据需要查看代码提交记录与工作项之间的关联关系如何将提交的代码关联到工作项代码提交信息按照 fix # 工作项编码格式书写, 即可实现代码与工作项的关联例如 : 工作项编码为 4567, 提交的代码用来解决 IE 浏览器的显示问题, 将代码关联到工作项的操作如表 3-3 所示表 3-3 代码关联工作项场景操作 Git 客户端使用命令 $ git commit -m "fix #4567 解决 IE 浏览器显示问题 ", 再进行代码上传文档版本 11 ( ) 版权所有华为技术有限公司 67

72 3 进阶操作场景远程仓库 ( 云端 ) 操作在云端编辑或上传代码文件时 : 1. 在仓库详情页面左侧导航选择仓库详情 2. 单击文件名称进入文件详情页面 3. 单击, 编辑文件后, 在提交信息框内使用 fix 格式 ( 如 fix #4567 解决 IE 浏览器显示 ) 关联项目中的工作项说明使用 fix 填写提交信息的场景包括 : 新建编辑修改删除文件以及本地 Git 客户端提交 (Commit) 代码如何查看提交代码与工作项的关联关系代码提交记录与工作项之间的关联关系, 可以通过如表 3-4 所示方法查看表 3-4 代码关联关系场景项目管理操作 1. 在项目管理中查找目标项目 2. 进入工作项详情, 在页面下方找到代码提交记录页签, 单击记录中的代码仓库节点链接 ( 数字串 ), 即可定位到对应代码, 如图 3-35 所示图 3-35 代码提交记录代码托管 1. 在代码托管中查找目标仓库 2. 单击目标仓库所在行, 进入关联列表页面, 可以查看代码提交关联的工作项, 如图 3-36 所示图 3-36 关联列表文档版本 11 ( ) 版权所有华为技术有限公司 68

73 3 进阶操作提交历史背景信息开发人员可以查看每次提交代码的历史列表操作步骤 1. 进入代码仓库详情页面, 并在仓库详情页面提交代码 2. 单击左侧导航区提交, 显示历史列表页面, 如图 3-37 所示图 3-37 历史列表新建分支背景信息操作步骤 3. 根据实际情况可以选择分支起始时间进行过滤 4. 单击历史记录提交号可以查看提交详情分支是用来将特性开发绝缘开来的使用分支意味着把工作从开发主线上分离开来, 以免影响开发主线在创建仓库时,master 是默认的主分支在其他分支上进行开发, 完成后再将它们合并到主分支上代码托管新建分支的场景及操作方法如表 3-5 所示文档版本 11 ( ) 版权所有华为技术有限公司 69

74 3 进阶操作表 3-5 新建分支场景场景远程仓库 ( 云端 ) 操作方法 1. 进入代码仓库详情页面 2. 单击远程仓库左侧导航区分支, 显示分支列表页面, 如图 3-38 所示图 3-38 分支列表 3. 单击新建分支本地仓库 ( 新建分支再 Push 到远程仓库 ) Git 客户端 1. 在 master 或其他分支下 ( 本地分支 ), 输入命令 git checkout -b slave 新建一个分支 2. 输入命令 git push origin slave 把分支推送到远程仓库 EGit 客户端 1. 登录 Git 仓库页面, 单击 branchs > local 2. 选中 master 右键选择新建分支, 输入分支的名称 3. 单击确定 ( 默认在 master 下新建分支 ) 4. 选中新分支, 右键选择 push branch, 推送分支到远程仓库 TortoiseGit 客户端 1. 选中本地库, 右键选择 tortoisegit > create branch 新建分支 2. 切换到新分支上, 右键选择 push branch, 推送分支到远程仓库创建标签背景信息操作步骤 Git 标签通常用来标记发布里程碑 ( 如 v1.0), 可以给历史中的某一个提交打上标签, 以示重要代码托管创建标签的场景及操作方法如表 3-6 所示文档版本 11 ( ) 版权所有华为技术有限公司 70

75 3 进阶操作表 3-6 创建标签场景场景远程仓库 ( 云端 ) 操作方法 1. 进入代码仓库详情页面 2. 单击远程仓库左侧导航区标签, 显示标签列表页面 3. 单击新建标签新建 Git 标签 ( 如 v1.0) 已创建的标签显示在标签列表中 4. ( 可选 ) 单击可以删除标签本地仓库 ( 新建标签再 Push 到远程仓库 ) Git 客户端 1. 在 master 分支上, 输入命令 git tag -a V m V1.0.0 版本 (- a 加标签 -m 加标签注释 ) 新建标签 2. 输入命令 git checkout V1.0.0 切换到标签 V1.0.0 上 3. 输入命令 git push origin V1.0.0 或 git push origin --tags 到远程仓库 EGit 客户端 TortoiseGit 客户端 1. 选中 Git 仓库视图的 Tags 右键选择 Create tag 新建标签 2. 输入标签的名称以及注释 3. 切换到标签上 4. 右键选择 remote > push, 选择添加所有 tags, 标签即被推送到远程仓库 1. 选中本地库 master 分支, 右键选择 tortoisegit > Create tag 2. 输入标签的名称以及注释 3. 切换到标签上 4. 右键选择 remote > push, 选择添加所有 tags, 标签即被推送到远程仓库分支对比 1. 进入代码仓库详情页面 2. 单击远程仓库左侧导航区分支对比, 显示分支对比页面, 可以对比已有分支, 如图 3-39 所示图 3-39 分支对比 3. 选择需要比较的分支后, 单击对比即显示对比结果文档版本 11 ( ) 版权所有华为技术有限公司 71

76 3 进阶操作合并分支背景信息操作步骤使用其他分支进行开发后, 需要将它们合并到主分支 ( 默认 master 为主分支 ) 上代码托管合并分支的场景及操作方法如表 3-7 所示表 3-7 合并分支场景场景远程仓库 ( 云端 ) 操作方法远程仓库合并分支,master/slave 分支有新增的文件, 需要把 slave/ master 合并到 master/slave: 1. 分支对比比较从 slave 到 master 的不同, 分支不同可进行合并 2. 合并分支把源分支 (master/slave) 合并到目标分支 (slave/master) 上, 合并完成后 slave/master 会有新增的文件本地仓库 ( 合并分支再 Push 到远程仓库 ) Git 客户端 EGit 客户端 TortoiseGit 客户端 1. 在 master 分支上,master 和其他分支是不同的分支 ( 本地分支 ), 输入命令 git merge slave, 进行本地分支合并 2. 输入命令 git push origin master 把分支推送到远程仓库,master 上的文件即为合并后的 1. 选中本地库, 切换到 master 分支, 单击 team 右键选择 merge 2. 选择 devlop 分支, 进行本地分支的合并 3. Push master 分支到远程仓库 1. 选中本地库 master 分支, 右键选择 tortoisegit > merge 2. 选择 devlop 分支, 进行本地分支的合并 3. 右键选择 push branch, 推送分支到远程仓库仓库网络背景信息操作步骤仓库网络即通过仓库网络时间轴可以查看仓库关系 1. 进入代码仓库详情页面 2. 单击左侧导航区仓库网络, 显示仓库网络时间轴, 如图 3-40 所示文档版本 11 ( ) 版权所有华为技术有限公司 72

3 进阶操作图 3-40 仓库网络时间轴 3.5.9 仓库统计背景信息按照贡献者的提交次数添加代码行数或删除代码行数以及不同维度显示提交统计操作步骤 1. 进入代码仓库详情页面 2.

77 3 进阶操作图 3-40 仓库网络时间轴仓库统计背景信息按照贡献者的提交次数添加代码行数或删除代码行数以及不同维度显示提交统计操作步骤 1. 进入代码仓库详情页面 2. 单击左侧导航区仓库统计, 默认显示贡献者页签, 显示贡献者统计情况, 如图 3-41 所示图 3-41 代码仓库趋势图 3. 单击提交页签, 显示不同维度的提交统计, 如图 3-42 所示文档版本 11 ( ) 版权所有华为技术有限公司 73

79 3 进阶操作 3.6 代码冲突代码冲突分析背景信息提交代码时, 常常会出现冲突, 尤其是协同开发的情况例如, 共同维护一个工程模块, 均把测试项往上提交, 可能会涉及到一些公共接口文件以及资源文件提交, 不可避免的会发生这些文件的提交冲突开发代码过程中, 需要遵循 Git 使用规范, 以减少产生冲突的情况提交代码之前, 请做如下操作 : 操作步骤 1. 查看目前代码的修改状态, 运行 git status 命令检查目前所做的修改已暂存 (changes to be committed) 已修改 (changed but not updated) 未跟踪 (untracked files) 2. 查看代码修改内容比较某文件与最近提交节点的差异 :git diff <file> 比较某文件在提交节点 a 节点 b 的差异 :git diff <hashcode> <hashcode> <file> 说明如果该文件已暂存, 则 git diff cached<file> 如果省略后面一个 hashcode, 则默认表示与上一提交节点比较 ( 也可以利用 ^ 运算符 ) 3. 暂存需要提交的新建修改或删除文件新建的文件 :git add <file> 修改的文件 :git add <file> 删除的文件 :git rm <file> 4. 提交已暂存的文件 :git commit 说明注意注释填写规范如果提交注释书写有误或漏提文件, 可以使用命令 :git commit -- amend( 修改最近一次提交 ) 5. 同步到服务器 a. 将服务器代码同步到本地 :git pull b. 同步到服务器 :git push origin < 本地分支名 > 说明如果 git pull 失败, 请按照提示还原有冲突的文件, 再次尝试同步 :git checkout -- < 有冲突的文件路径 > 文档版本 11 ( ) 版权所有华为技术有限公司 75

80 3 进阶操作解决多人提交代码产生的冲突与覆盖背景信息开发人员 A 请求 worker1 往 master 上 merge, 开发人员 B 请求 worker2 也往 master 上 merge 即,A 和 B 两位开发者有可能都改了同一个文件, 就可能会产生冲突此时,master 分支上就可能会出乱对于提交代码到 Git 服务器, 多人修改了分支文件时,merge 过程会产生文件内容冲突 Git 通过 Merge Request 的思路来解决类似的冲突下面介绍如何进行 Merge Request, 让 master 上的分支一直正确, 不产生冲突操作步骤 1. 开发者做完了一天的工作, 在 worker1(l) 分支上开发完代码 2. Checkout 到 master(l) 上,Pull 一下, 把服务器上 master 的代码拉下来, 保证本地 master(l) 是最新 master 代码 3. Checkout 回 worker1(l) 分支, 将 master(l) 分支 merge 到 worker1(l) 上说明该步骤可能会发生冲突 : 因为在开发者下班之前,worker2 分支的同事可能已提交代码并更新 master, 而恰巧修改了同一个文件此时冲突发生在本地 ( 不要紧 ) 4. ( 可选 ) 解决本地冲突 5. Push 代码到 worker1 分支, 再提 Merge Request 说明此时就不会使服务器上的 master 产生代码冲突了 ; 因为在本地解决冲突时,Git 就已经知道产生冲突以后该怎么做, 而又把这些脚本 Push 到了服务器的 worker1 分支上, 那么服务器的 worker1 分支在往 master 分支合并时自然就知道该怎么做后续处理当您早上来上班时, 尽量先 checkout 到 master(l),pull 一下, 再 checkout 回 worker1(l), 把 master(l) 分支的内容 merge 过来, 完成之后再进行开发这样就尽量保持在昨晚之后的最新代码上进行开发, 以减少产生冲突的可能性 3.7 仓库备份打包 ( 下载 ) 代码仓库背景信息在 DevCloud 代码托管中创建好代码仓库, 并开发好代码后, 开发人员可以根据需要对云端仓库代码进行打包下载操作步骤 1. 进入目标代码仓库详情页面 2. 单击下载文件, 如图 3-44 所示文档版本 11 ( ) 版权所有华为技术有限公司 76

81 3 进阶操作图 3-44 下载文件 3. 选择文件包下载格式 ( 如 zip ), 将仓库代码以 zip 格式文件 ( 如 CodeHub01- master-xxxx.zip ) 下载到本地 3.8 代码广场创建公有代码仓库操作步骤 1. 创建公有代码仓库在代码托管首页, 单击新建仓库, 选择公有属性, 如图 3-45 所示公有代码仓库新建完成后, 显示在代码广场中图 3-45 新建公有代码仓库 2. 登录代码广场首页文档版本 11 ( ) 版权所有华为技术有限公司 77

82 3 进阶操作在 DevCloud 首页工具栏单击代码广场进入, 如图 3-46 所示图 3-46 代码广场首页 3. 推荐公开代码仓库由系统推荐, 包括四种类型 : 人气最高口碑最佳上升最快和最新上架用户单击代码广场首页任一推荐的代码仓库, 即进入该代码仓库的详情页单击更多可查看该类型下的所有代码仓库 4. 搜索公开代码仓库在首页上方的搜索框内输入搜索条件, 单击搜索按钮或回车即可查询结果, 如有匹配的结果则列表显示, 如图 3-47 所示图 3-47 搜索代码仓库文档版本 11 ( ) 版权所有华为技术有限公司 78

查看本用户关注的所有公开代码仓库在我的页签中, 单击左侧导航关注的代码菜单项, 即可查看到本用户关注的所有公开代码仓库 8. 克隆 (Fork) 公开代码仓库 a. 在代码广场首页单击任一推荐类型项后的更多, 进入代码列表页 b.

83 3 进阶操作 5. 对代码仓库搜索结果过滤在代码仓库搜索结果左侧过滤区域有过滤选项, 可通过选择代码类别或语言标签, 对搜索结果做进一步的筛选 6. 查看本用户的所有公开代码仓库在代码广场首页选择我的页签, 左侧导航默认显示已公开的代码菜单项内容, 如图 3-48 所示图 3-48 我的公有代码仓库 7. 查看本用户关注的所有公开代码仓库在我的页签中, 单击左侧导航关注的代码菜单项, 即可查看到本用户关注的所有公开代码仓库 8. 克隆 (Fork) 公开代码仓库 a. 在代码广场首页单击任一推荐类型项后的更多, 进入代码列表页 b. 单击列表项中的图标, 弹出 Fork 仓库窗口, 如图 3-49 所示图 3-49 克隆公开代码仓库 c. 设置新的仓库名称和归属项目, 单击确定按钮, 即可完成仓库克隆克隆完成的代码仓库显示在代码托管首页, 其名称前的图标表示公有代码仓库 9. 评价公开代码仓库 a. 在代码广场首页单击任一推荐类型项后的更多, 进入代码列表页 b. 单击列表项中的图标, 在弹出的评价对话框中, 选择对应的星标 c. 单击保存即可完成评价文档版本 11 ( ) 版权所有华为技术有限公司 79

84 3 进阶操作 10. 关注 / 取消关注公开代码仓库切换公有 / 私有代码仓库背景信息 a. 关注公开代码仓库 : 在代码广场首页单击任一推荐类型项后的更多, 进入代码列表页单击列表项中的图标即可完成关注 b. 取消关注公开代码仓库 : 在代码广场首页单击任一推荐类型项后的更多, 进入代码列表页单击列表项中的图标即可完成取消关注代码仓库支持私有和公有两种类型, 根据实际需要可以在两者之间进行切换操作步骤 1. 进入代码仓库详情页面 2. 单击左侧导航区设置 > 基本设置, 进入基本设置页面, 如图 3-50 所示图 3-50 基本设置 3. 设置代码仓库描述新和是否公开类型 ( 私有或公有 ) 4. 单击确认文档版本 11 ( ) 版权所有华为技术有限公司 80

85 4 更多 Git 知识 4 更多 Git 知识 4.1 Git 客户端使用 4.2 TortoiseGit 客户端使用 4.3 Git 客户端示例 4.4 Git 常用命令 4.5 Git LFS 使用 4.6 Git 常见异常信息处理 4.1 Git 客户端使用背景信息前提条件使用流程使用 Git 客户端前, 需要了解 Git 安装创建新仓库检出仓库工作流添加与提交推送改动创建分支更新与合并分支创建标签替换本地改动等基本操作如果没有安装 Git 客户端, 请到下载最新版本 Git 客户端基本使用流程如图 4-1 所示文档版本 11 ( ) 版权所有华为技术有限公司 81

4 更多 Git 知识图 4-1 Git 客户端基本使用流程使用流程说明操作步骤说明安装根据需要安装对应版本 : Git Windows 版 Git OSX 版 OSX 版 OSX 版 OSX 版 Git Linux 版新建仓库创建新文件夹, 打开, 然后执行如下命令 : git init 以创建新的 git

86 4 更多 Git 知识图 4-1 Git 客户端基本使用流程使用流程说明操作步骤说明安装根据需要安装对应版本 : Git Windows 版 Git OSX 版 OSX 版 OSX 版 OSX 版 Git Linux 版新建仓库创建新文件夹, 打开, 然后执行如下命令 : git init 以创建新的 git 仓库检出仓库创建一个本地仓库的克隆版本, 执行如下命令 : git clone /path/to/repository 如果是远端服务器上的仓库, 命令为 : git clone username@host:/path/to/repository 文档版本 11 ( ) 版权所有华为技术有限公司 82

87 4 更多 Git 知识操作步骤说明工作流本地仓库由 Git 维护的三棵树组成 : 工作目录 : 持有实际文件缓存区 (Index): 像个缓存区域, 临时保存做的改动 HEAD: 指向最近一次提交后的结果添加与提交将改动内容添加到缓存区, 使用如下命令 : git add <filename> git add * 这是 Git 基本工作流程的第一步 ; 使用如下命令提交实际改动 : git commit -m " 代码提交信息 " 此时改动已经提交到了 HEAD, 但是还没到远端仓库推送改动创建分支更新与合并 ( 分支 ) 改动内容目前已经在本地仓库的 HEAD 中执行如下命令以将这些改动提交到远端仓库 : git push origin master 可以将 master 换成需要推送的任何分支如果没有克隆现有仓库, 且需要将仓库连接到某个远程服务器, 可以使用如下命令添加 : git remote add origin <server> 将改动推送到所添加的服务器上分支是用来将特性开发绝缘开来的在创建仓库时,master 是默认的主分支在其他分支上进行开发, 完成后再将它们合并到主分支上 1. 创建一个名为 feature_x 的分支, 并切换过去 : git checkout -b feature_x 2. 切换回主分支 : git checkout master 3. 将分支推送到远端仓库 ( 不推送该分支, 就仅自己所见 ): git push origin <branch> 4. 再把新建的分支删掉 : git branch -d feature_x 1. 更新本地仓库至最新改动, 执行 : git pull 以在你的工作目录中获取 (fetch) 并合并 (merge) 远端的改动 2. 合并其他分支到当前分支 ( 如 master), 执行 : git merge <branch> 说明两种情况下,Git 都会尝试去自动合并改动但自动合并并非次次都能成功, 并可能导致冲突 (conflicts) 这时候就需要修改这些文件, 手动合并这些冲突 (conflicts) 3. 改完之后, 需要执行如下命令将它们标记为合并成功 : git add <filename> 4. 在合并改动之前, 也可以使用如下命令查看 : git diff <source_branch> <target_branch> 文档版本 11 ( ) 版权所有华为技术有限公司 83

88 4 更多 Git 知识操作步骤创建标签说明在软件发布时创建标签, 是被推荐的可以执行如下命令以创建一个名为的标签 : git tag b2e1d63ff 1b2e1d63ff 是要标记的提交 ID 的前 10 位字符使用如下命令获取提交 ID: git log 也可以用该提交 ID 的少一些的前几位, 保持 ID 唯一即可替换本地改动如果误操作, 可以使用如下命令替换掉本地改动 : git checkout -- <filename> 此命令会使用 HEAD 中的最新内容替换掉工作目录中的文件已添加到缓存区的改动, 以及新文件, 均不受影响如果需要丢弃所有的本地改动与提交, 可以到服务器上获取最新的版本并将本地主分支指向到它 : git fetch origin git reset --hard origin/master 4.2 TortoiseGit 客户端使用 TortoiseGit 客户端生成 PPK 文件使用 TortoiseGit 作为客户端时, 下载和提交代码需要 PPK 文件, 主要有如下两种场景 : Git 客户端生成了公私钥对, 并将该公钥添加到代码仓库的 ssh-key 配置中此前未添加互信操作, 即没有添加公钥到代码仓库中 Git 客户端生成了公私钥对, 并将该公钥添加到代码仓库的 ssh-key 配置中 1. 在开始菜单, 选择 TortoiseGit > PuttyGen, 如图 4-2 所示图 4-2 PuttyGen 文档版本 11 ( ) 版权所有华为技术有限公司 84

选择用户的公私钥目录下的 id_rsa 文件, 然后单击打开按钮, 如图 4-4 所示图

90 4 更多 Git 知识图 4-5 Save private key 5. 根据提示单击是 (Y) 确定生成 6. 保存到用户的个人账户公私钥目录下, 如图 4-6 所示图 4-6 PPK 文件保存目录此前未添加互信操作, 即没有添加公钥到代码仓库中 1. 在开始菜单, 选择 TortoiseGit > PuttyGen, 如图 4-7 所示文档版本 11 ( ) 版权所有华为技术有限公司 86

4 更多 Git 知识图 4-9 Save private key 4. 根据提示单击是 (Y) 确定生成 5. 保存到用户的个人账户公私钥目录下, 如图 4-10 所示图 4-10 PPK 文件保存目录 4.2.

92 4 更多 Git 知识图 4-9 Save private key 4. 根据提示单击是 (Y) 确定生成 5. 保存到用户的个人账户公私钥目录下, 如图 4-10 所示图 4-10 PPK 文件保存目录 TortoiseGit 客户端创建 Git 版本库第一次建立版本库时, 在本地任意空的文件夹下右键, 选择 Git Creat repository here 文档版本 11 ( ) 版权所有华为技术有限公司 88

4 更多 Git 知识 4.2.4 TortoiseGit 客户端 Push 版本库 1. 配置用户名邮箱和签名密钥 (PPK 文件 ) 2. 在空白处右键, 选择 TortoiseGit > setting 3. 选中 Git 节点, 如图 4-14 所示, 填写用户与邮箱地址图 4-14 Git User Info 说明如果不能 Push, 请运行如下脚本进行排查, 并将生成的 git.

95 4 更多 Git 知识 TortoiseGit 客户端 Push 版本库 1. 配置用户名邮箱和签名密钥 (PPK 文件 ) 2. 在空白处右键, 选择 TortoiseGit > setting 3. 选中 Git 节点, 如图 4-14 所示, 填写用户与邮箱地址图 4-14 Git User Info 说明如果不能 Push, 请运行如下脚本进行排查, 并将生成的 git.log 发给售后支持 : #!/bin/bash # this script will collect some logs for Coding.net ### how to use ### # first enter your git reposiztory # then execute this bash, please make sure you have correct rights echo "## git version ##################" >> git.log git version >> git.log echo "## ping ##########################" >> git.log ping codehub.devcloud.hwclouds.com >> git.log echo "## curl codehub.devcloud.hwclouds.com ###########" >> git.log curl -v >> git.log 2>&1 echo "## ssh -vt git@codehub.devcloud.hwclouds.com ##############" >> git.log ssh -vt git@codehub.devcloud.hwclouds.com >> git.log 2>&1 echo "## git pull ##############" >> git.log GIT_CURL_VERBOSE=1 GIT_TRACE=1 GIT_TRACE_PACKET=1 git pull >> git.log 2>&1 4.3 Git 客户端示例文档版本 11 ( ) 版权所有华为技术有限公司 91

4 更多 Git 知识 4.3.1 Git 客户端上传下载代码 1. 检查网络在浏览器中访问代码仓库地址 :telnet codehub.devcloud.hwclouds.com 22 2.

com 如果出现如图 4-15 所示信息则表示互信正常图 4-15 互信信息 3. 如果已添加代码仓库的互信, 双方指纹信息有变化, 在提交代码时报公钥认证出错, 需要做如下操作 : a. 删除 ~/.ssh/known_hosts 中 codehub.devcloud.hwclouds.

96 4 更多 Git 知识 Git 客户端上传下载代码 1. 检查网络在浏览器中访问代码仓库地址 :telnet codehub.devcloud.hwclouds.com 检查客户端和代码托管服务器互信如果在 pull push 时提示要输入密码, 请确定是否已经添加了公钥文件添加完成后, 判断互信是否添加成功 :$ ssh -vt 如果出现如图 4-15 所示信息则表示互信正常图 4-15 互信信息 3. 如果已添加代码仓库的互信, 双方指纹信息有变化, 在提交代码时报公钥认证出错, 需要做如下操作 : a. 删除 ~/.ssh/known_hosts 中 codehub.devcloud.hwclouds.com 相关的行 b. 重试 push pull 或 ssh -T git@codehub.devcloud.hwclouds.com c. 遇到询问是否信任服务器公钥, 输入 yes 即可 4. 代码正常下载, 如果页面分支列表做了分支保护, 提交的分支会显示在已受保护分支列表中, 则向某个分支 Push 代码会不成功, 如图 4-16 所示图 4-16 Push 代码文档版本 11 ( ) 版权所有华为技术有限公司 92

97 4 更多 Git 知识 5. 联系仓库管理员解除分支保护, 解除保护后, 开发人员可以正常提交代码 Git 客户端设置 Windows 下的字符编码背景信息操作步骤在 Linux 及托管网站上默认的字符编码均是 UTF-8, 而 Windows 系统默认编码不是采用 UTF-8 如果不设置 Git 字符编码为 UTF-8,Git 客户端在 Windows 下中文内容可能会出现乱码设置字符编码后, 可以解决中文显示的问题步骤 1 设置 Git 编码为 UTF-8 $ git config --global core.quotepath false # 显示 status 编码 $ git config --global gui.encoding utf-8 # 图形界面编码 $ git config --global i18n.commit.encoding utf-8 # 提交信息编码 $ git config --global i18n.logoutputencoding utf-8 # 输出 log 编码 $ export LESSCHARSET=utf-8 # 最后一条命令是因为 git log 默认使用 less 分页, 所以需要 bash 对 less 命令进行 utf-8 以上命令等效于 : 在 etc\gitconfig 中添加 : [core] [gui] [i18n] quotepath = false encoding = utf-8 commitencoding = utf-8 logoutputencoding = utf-8 在 etc\profile 中添加 : export LESSCHARSET=utf-8 说明 gui.encoding = utf-8 解决在 $ git gui 和 gitk 中的中文乱码如果发现代码中的注释显示乱码, 可以设置项目根目录中 git/config 文件添加 :[gui] encoding = utf-8 i18n.commitencoding = utf-8 设置 commit log 提交时使用 utf-8 编码, 可避免服务器上乱码, 同时与 Unix 上的编码提交保持一致 i18n.logoutputencoding = gbk 保证在 $ git log 时编码设置为 utf-8 export LESSCHARSET=utf-8 保证 $ git log 可以正常显示中文 ( 配合 i18n.logoutputencoding 设置 ) 步骤 2 设置 ls 命令可以显示中文名称修改 etc\git-completion.bash 文件 :alias ls="ls --show-control-chars --color" ---- 结束 Git 客户端修改文件名大小写后, 如何提交到远端背景信息 Git 修改了文件名大小写后, 远端将不识别对应文件例如 : 远端服务器 AppTest.java, 本地重命名后 apptest.java, 提交后远端还是 AppTest.java 文档版本 11 ( ) 版权所有华为技术有限公司 93

98 4 更多 Git 知识操作步骤请按顺序执行如下命令 : git mv --force AppTest.java apptest.java git add apptest.java git commit m "rename" git push origin XXX( 分支 ) Git 客户端设置系统的换行符转换背景信息由于操作系统不兼容的缘故, 在跨平台上查看文本文件会因为换行符不同而造成障碍, 使用版本控制系统也同样存在换行符的问题操作步骤 1. ( 可选 ) 默认 Git 不对 core.autocrlf 进行配置, 请设置如下值来辨别并对文本文件执行换行符转换 : Windows 系统设置配置变量 core.autocrlf 为 true, 相当于在版本库中所有的文本文件都使用 LF 作为换行符, 而检出到工作区无论是什么操作系统都使用 CRLF 作为换行符 Linux 系统设置配置变量 core.autocrlf 为 input, 相当于在新增入库的文本文件的换行符自动转换为 LF, 如果将文件从版本库检出到工作区则不进行文件转换 2. 通过配置变量 core.autocrlf 来开启文本文件换行符转换的功能 : git config --global core.autocrlf true Git 客户端提交中文名文件背景信息在 Git 客户端中, 提交文件时, 如果文件名是中文, 会出现乱码操作步骤避免中文文件名出现乱码的几种提交场景操作方法如表 4-1 所示表 4-1 中文名文件提交场景场景在 Git 客户端中, 使用 git add 添加要提交的文件时, 如果文件名是中文, 会显示形如 256\346\200\273\347\273\2 23.png 的乱码操作方法在 bash 提示符下输入 : git config --global core.quotepath false 文档版本 11 ( ) 版权所有华为技术有限公司 94

4 更多 Git 知识场景使用 git log 提交显示中文 Log 乱码在 MsysGit 自带的 bash 中, 使用 ls 命令查看中文文件名乱码,cygwin 没有该问题操作方法 1. 设置 git gui 的界面编码 : git config --global gui.encoding utf-8 2.

99 4 更多 Git 知识场景使用 git log 提交显示中文 Log 乱码在 MsysGit 自带的 bash 中, 使用 ls 命令查看中文文件名乱码,cygwin 没有该问题操作方法 1. 设置 git gui 的界面编码 : git config --global gui.encoding utf-8 2. 设置 commit log 提交时使用 utf-8 编码, 可避免服务器上乱码, 同时与 Linux 上的提交保持一致 : git config --global i18n.commitencoding utf-8 3. 使得在 $ git log 时将 utf-8 编码转换成 gbk 编码, 解决 Msys bash 中 git log 乱码 : git config --global i18n.logoutputencoding gbk 4. 使得 git log 可以正常显示中文 ( 配合 i18n.logoutputencoding = gbk ), 在 /etc/ profile 中添加 : export LESSCHARSET=utf-8 1. 使用 ls --show-control-chars 命令来强制使用控制台字符编码显示文件名, 即可查看中文文件名为了方便使用, 可以编辑 /etc/gitcompletion.bash, 新增一行 : alias ls="ls --show-control-chars" 2. 重启 Git 客户端即可生效 Git 客户端提交隐藏文件请使用 git add. 说明不能使用 git add *, 使用 * 会忽略隐藏文件文件和文件夹名称中不能包含特殊字符 Git 客户端提交已被更改的文件背景信息 Git 提交代码时, 如果文件被修改了, 会出现如图 4-17 所示信息图 4-17 提交代码文档版本 11 ( ) 版权所有华为技术有限公司 95

100 4 更多 Git 知识操作步骤 1. 拉取远端最新代码 git pull origin XXX( 分支 ) 2. 正确修改并提交代码 git push origin XXX( 分支 ) 4.4 Git 常用命令背景信息 Git 是一款免费开源的分布式版本控制系统, 用于敏捷高效地处理任何或大或小的项目, 能有效高速地处理从很小到非常大的项目版本管理通过 Git 可以从服务器克隆完整的 Git 仓库 ( 包括代码和版本信息 ) 到单机上, 然后根据不同开发目的灵活创建分支修改代码提交代码合并分支等常用命令 Git 常用命令的功能格式参数说明以及使用实例如表 4-2 所示表 4-2 Git 常用命令命令功能格式参数说明使用实例 ssh keygen t rsa 生成密钥 ssh keygen t rsa C [ ] emai l: 邮箱地址在 C 盘.ssh 文件夹下获取密钥文件 id_rsa.pub ssh keygen t rsa C "devcloud_key01@huawei.com" git branch 新建分支 git branch [new branchname] new bran chna me : 新的分支名新建分支 : git branch newbranch git branch D 删除分支 git branch D [new branchname] new bran chna me : 新的分支名删除本地分支 : git branch D newbranch 删除服务器仓库分支 git branch rd origin/newbranch 同步远端已删除的分支 git remote prune origin git add 添加文件到暂存区 git add [filename] filen ame : 文件名添加一个文件到暂缓区 : git add filename 添加所有修改的和新增的文件到暂缓区 : git add. 文档版本 11 ( ) 版权所有华为技术有限公司 96

101 4 更多 Git 知识命令功能格式参数说明使用实例 git rm 删除本地目录或文件 git rm [filename] filen ame : 文件名或目录名删除文件 : git rm filename git clone 克隆远程仓库 git clone [VersionAddres s] Versi ona ddre ss: 版本库的网址克隆 jquery 的版本库 : git clone jquery.git 该命令会在本地主机生成一个目录, 与远程主机的版本库同名 git pull 把远程仓库的分支 pull 到本地, 再与本地的指定分支合并 git pull [RemoteHostna me] [RemoteBranch name]: [LocalBranchn ame] - 取回 origin 主机的 next 分支, 与本地的 master 分支合并 : git pull origin next:master git diff git commit 文件分支目录或版本的比较文件提交 git diff - 当前与 master 分支的比较 : git diff master git commit - 添加提交信息 : git commit m "commit message" 文档版本 11 ( ) 版权所有华为技术有限公司 97

102 4 更多 Git 知识命令功能格式参数说明使用实例 git push 推送文件到远程仓库 git push [RemoteHostna me] [LocalBranchn ame] [RemoteBranch name] - 如果省略远程分支名, 则表示将本地分支推送与之存在追踪关系的远程分支 ( 通常两者同名 ), 如果该远程分支不存在, 则会被新建 : git push origin master 上面命令表示, 将本地的 master 分支推送到 origin 主机的 master 分支如果后者不存在, 则会被新建 git merge 合并分支 git merge [branch] bran ch: 分支名假设当前分支为 develop, 将 master 主分支之后的最新提交 merge 到当前的 develop 分支上 : git merge master git checkout 切换分支 git checkout [branchname] bran chna me : 分支名切换到 master 分支 : git checkout master git log git status git grep git show 列出日志信息查看状态输出查找字符串显示内容或修改的内容 git log - 列出所有的 log: git log -all git status - git status git grep - 查找是否有 hello 字符串 : git grep "hello" git show - git show v1 显示 tag v1 的修改内容 git show HEAD 显示当前版本的修改文件 git show HEAD^ 显示前一版本所有的修改文件 git show HEAD~4 显示前 4 版本的修改文件文档版本 11 ( ) 版权所有华为技术有限公司 98

103 4 更多 Git 知识命令功能格式参数说明使用实例 git stash git lsfiles git remote 暂存区查看文件操作远程 git stash - git stash list 列出暂存区的文件 git stash pop 取出最新的一笔, 并移除 git stash apply 取出但不移除 git stash clear 清除暂存区 git ls-files - git ls-files d 查看已经删除的文件 git ls-files d xargs git checkout 将已删除的文件还原 git remote - git push origin master:newbranch 增加远程仓库的分支 git remote add newbranch 增加远程仓库的分支 git remote show 列出现在远程有多少版本库 git remote rm newbranch 删除远程仓库的新分支 git remote update 更新远程所有版本的分支 4.5 Git LFS 使用背景信息代码托管支持 Git LFS(Large File Storage, 大文件存储 ) 协议, 可以把音乐图片视频等指定的任意大文件资源存储在 Git 仓库之外, 对于使用者而言, 类似在操作一个完整的 Git 仓库, 非常方便通过将大文件存储在 Git 原有的数据结构之中, 可以减小 Git 仓库本身的体积, 使克隆 Git 仓库的速度加快, 也使得 Git 不会因为仓库中充满大文件而损失性能使用操作包含以下内容 : 安装 Git LFS 配置追踪文件提交大文件克隆包含 Git LFS 文件的远程仓库更多操作文档版本 11 ( ) 版权所有华为技术有限公司 99

104 4 更多 Git 知识安装 Git LFS 不同操作系统的安装方法如表 4-3 所示表 4-3 Git LFS 安装方法操作系统 Windows 安装方法安装不低于 Git 版的 Git 客户端 ( 下载地址 ), 然后在命令行中执行 : git lfs install Linux 在命令行中执行 : $ curl -s script.deb.sh sudo bash $ sudo apt-get install git-lfs $ git lfs install MacOS 首先安装 Homebrew, 然后在命令行中执行 : $ /usr/bin/ruby -e "$(curl -fssl install/master/install)" $ brew install git-lfs $ git lfs install 配置追踪文件配置追踪文件方法如表 4-4 所示表 4-4 追踪文件配置方法场景追踪所有后缀名为.psd 的文件追踪单个文件查看已追踪的文件方法追踪所有后缀名为.psd 的文件 :git lfs track "*.psd" 追踪单个文件 :git lfs track "logo.png" 查看已追踪的文件, 可以通过 git lfs track, 或通过查看.gitattributes 文件, 获取详情 : $ git lfs track Listing tracked patterns *.png (.gitattributes) *.pptx (.gitattributes) $ cat.gitattributes *.png filter=lfs diff=lfs merge=lfs -text *.pptx filter=lfs diff=lfs merge=lfs -text 提交大文件提交代码时需要将.gitattributes 文件也提交到仓库, 提交完成后, 执行 git lfs ls-files 命令可以查看 LFS 跟踪的文件列表 $ git push origin master Git LFS: (2 of 2 files)12.58 MB / MB 文档版本 11 ( ) 版权所有华为技术有限公司 100

105 4 更多 Git 知识 Counting objects: 2, done. Delta compression using up to 8 threads. Compressing objects: 100% (5/5), done. Writing objects: 100% (5/5), 548 bytes 0 bytes/s, done. Total 5 (delta 1), reused 0 (delta 0) To <URL> <SHA_ID1>..<SHA_ID2> master -> master $ git lfs ls-files 61758d79c4 * <FILE_NAME_1> a227019fde * <FILE_NAME_2> 克隆包含 Git LFS 文件的远程仓库使用 git lfs clone 命令克隆包含 Git LFS 文件的远程仓库到本地 : $ git lfs clone <URL> Cloning into '<dirname>' remote: Counting objects: 16,done. remote: Compressing objects: 100% (12/12),done. remote: Total 16 (delta 3), reused 9 (delta 1) Receiving objects: 100% (16/16),done. Resolving deltas: 100% (3/3),done. Checking connectively...done. Git LFS: (4 of 4 files) 0 B / 100 B 更多操作查看 Git-LFS 官方网站 : 4.6 Git 常见异常信息处理用户在使用 Git 进行代码管理时, 不可避免会遇到一些常见的异常, 请根据实际情况正确处理 Git 的常见异常处理方法如表 4-5 所示表 4-5 Git 异常处理异常信息原因分析处理方法使用 git add 命令时, 提示 Not a git respository 向代码仓库推送代码时, 提示 You are not allowed to push code to protected branches on this project 当前所处的目录并非代码仓库目录该分支为受保护分支, 用户没有权限推送代码到这个分支代码仓库中受保护的分支会阻止仓库管理员以外的人推送代码需要找到本地代码仓库目录地址, 通过命令 :$ cd 仓库目录, 切换到代码仓库中再进行 add 操作仓库管理员可以通过如下两种设置解决 : 修改分支保护设置修改仓库成员角色, 将该成员设置为仓库管理员文档版本 11 ( ) 版权所有华为技术有限公司 101

106 4 更多 Git 知识异常信息原因分析处理方法向代码仓库推送代码时, 提示 src refspec master does not match any 从云端克隆代码时, 提示 destination path 'demo' already exists and is not an empty directory 在 Centos 系统下使用 https 方式克隆代码时, 系统报 The requested URL returned error: 401 向云端仓库推送代码时, 提示 'origin' does not appear to be a git repository 使用 git pull 命令时, 提示 refusing to merge unrelated histories 本地的版本库中没有任何可供上传的文件所克隆的代码仓库已存在并且不为空通常是 Git 版本的问题云端的代码仓库没有初始化成功云端与本地的仓库不同使用 add 与 commit 命令, 将修改后的文件提交至暂存区中, 再使用 push 命令推送至云端代码仓库中在本地找到该代码仓库目录, 删除后, 重新克隆云端代码仓库至本地克隆项目至非空目录 1. 进入非空目录 : cd 本地代码仓库目录 2. 克隆云端代码仓库到临时目录 tmp 中 : $ git clone --no-checkout 云端代码仓库地址 tmp 3. 将 tmp 目录下的.git 目录移到当前目录 : $ mv tmp/.git 本地代码仓库目录名 4. 删除 tmp 目录 : $ rmdir tmp 5. 回退至上个版本 : $ git reset --hard HEAD 通过 #git --version 命令查看系统自带的版本, Centos6.5 自带的 Git 版本通常是卸载 Centos 自带的 Git1.7.1 # yum remove git 2. 到 Git 官网下载最新版本, 并将 Git 添加到环境变量中 # wget 版本号.tar.gz # tar zxvf 版本号.tar.gz # cd git- 版本号 # make configure #./configure --prefix=/usr/local/git --with-iconv=/usr/ local/libiconv # make all doc # make install install-doc install-html # echo "export PATH=$PATH:/usr/local/git/bin" >> /etc/ bashrc # source /etc/bashrc 使用 $ git push -u origin master 命令进行强制关联并推送使用命令 $ git pull origin master ----allow-unrelatedhistories 进行强制合并文档版本 11 ( ) 版权所有华为技术有限公司 102

4 更多 Git 知识异常信息原因分析处理方法向代码仓库推送代码失败使用 git pull 命令拉取代码失败 Git 密钥配置无误, 使用 Git 客户端命令可以正常 pull/push 代码, 但是在 android studio 上提示 could not read from remote repository SSL certificate problem: unable to

107 4 更多 Git 知识异常信息原因分析处理方法向代码仓库推送代码失败使用 git pull 命令拉取代码失败 Git 密钥配置无误, 使用 Git 客户端命令可以正常 pull/push 代码, 但是在 android studio 上提示 could not read from remote repository SSL certificate problem: unable to get local issuer certificate 从提示信息 (hint) 看, 由于云端代码仓库有变化, 与本地仓库代码不一致, 所以从本地提交代码的操作被拒绝由于云端仓库与本地仓库内容不一致, 拉取代码时会跟本地代码进行合并 (merge), 弹框是提示是否确认本次 merge 操作, 并提交备注信息通常是由于 android studio 的配置错误 SSL 证书问题 : 无法获取本地颁发者证书提交失败提示信息如图 4-18 所示图 4-18 提示信息先使用 $ git pull 命令拉取云端仓库, 与本地仓库合并, 再使用 push 命令推送代码拉取代码失败信息如图 4-19 所示图 4-19 提示信息按照以下步骤操作即可 : 1. 按键盘字母 i 进入 insert 模式 2. 输入确认信息 3. 输入 :wq, 按回车键保存退出按照以下操作修改设置即可 : 1. 选择 setting > Version Control > Git, SSH executable 2. 在 SSH executable 下拉列表中, 选择 Native 通常是由于用户处于 Proxy 之后的内网环境所致, 简单方案为 : git config --global http.sslverify false 文档版本 11 ( ) 版权所有华为技术有限公司 103