Git使用入门手册.docx

1、Git使用入门手册Git 使用入门手册版本/状态作者参与者日期备注1.02017/2/9初稿完成1.gitlab基础功能预览1.1欢迎页面访问地址：1.2 Profile显示个人相关的扼要描述。点击右上角图标，弹出下拉菜单，选择Profile选项。显示的内容包含：个人的活动信息、组信息、贡献的工程、个人的工程、代码片段。1.3 Settings个人相关信息设置及展示页面。点击右上角图标，弹出下拉菜单，选择Settings选项。内容包含：个人基础信息设置、账号信息设置、应用程序设置、聊天设置、访问令牌、邮箱设置、密码设置、通知设置、SSH keys设置、首选项、审计日志。1.4 Help帮助中心

2、。可查看gitlab的相关帮助文档。1.5 Sign out登出操作。1.6 Projectproject页面显示用户能够访问的工程列表。点击左上角的菜单图标，弹出左侧导航菜单，点击project。进入工程列表。点击工程名称，即可查看工程的相关信息。1.7 Activityactivity页面显示活跃的操作状态列表（即操作信息）。点击左上角的菜单图标，弹出左侧导航菜单，点击activity。进入活跃的操作状态列表。1.8 Groupgroup页面显示用户的组信息。点击左上角的菜单图标，弹出左侧导航菜单，点击group。进入用户的组信息页面。1.9 Milestonesmilestones页面显

3、示工程的里程碑信息。点击左上角的菜单图标，弹出左侧导航菜单，点击milestones。进入工程的里程碑信息页面。1.10 Issuesissues页面显示工程的问题列表。点击左上角的菜单图标，弹出左侧导航菜单，点击issues。进入工程的问题列表页面。1.11 Merge Requestsmerge requests页面显示收到的mrege请求信息。点击左上角的菜单图标，弹出左侧导航菜单，点击merge requests。进入mrege请求列表页面。1.12 Snippetssnippets页面显示收到的代码片段信息。点击左上角的菜单图标，弹出左侧导航菜单，点击snippets。进入代码片段列

4、表页面。2.添加 SSH KeyGitLab使用公钥或非对称加密，它通过用您的“私钥”锁定通信信道来加密通信信道，并允许可信方使用“公钥”解锁它。点击右上角用户图标，选择Settings 选项，选择SSH keys。根据页面描述可以看到，首先需要生成ssh key。2.1生成SSH Key安装Git工具后，进入git bash，输入 ssh-keygen 按照步骤，即可生成ssh key。另外，我们还可以通过eclipse附带的功能生成ssh key。Eclipse生成ssh key 步骤如下。1)，点击导航菜单栏Windows，选择Preferences，左侧搜索框输入SSH，点击搜索到的S

5、SH2节点，右侧SSH2面板选中Key Management选项卡，点击Generate RSA Key，即可生成ssh key。点击Save Private Key，即可保存（最好保存到默认的用户ssh key目录）。2.2添加SSH Key打开*.pub文件，复制内容，粘贴到gitlab中SSH Key（Settings - SSH keys）对应的textarea中，点击Add key即可。3.客户端配置安装完git，进入git bash，通过命令进行客户端配置。3.1设置用户信息配置命令如下：$ git config -global user.name John Doe$ git co

6、nfig -global user.email johndoe3.2设置客户端换行配置$ git config -global core.autocrlf fasle$ git config -global core.safecrlf true 4.开发过程EGit是eclipse IDE的集成开发工具。4.1安装egit插件url：http:/download.eclipse.org/egit/updates4.2 egit功能预览Commit：提交文件。Stashes：储藏操作。当你正在做一项复杂的工作时, 发现了一个和当前工作不相关但是又很讨厌的bug. 你这时想先修复bug再做手头的工

7、作, 那么就可以用 git stash 来保存当前的工作状态, 等你修复完bug后,执行反储藏(unstash)操作就可以回到之前的工作里。Push to Upstream：推送文件到服务器当前分支。Fetch from Upstream：从远程获取最新版本到本地仓库，不会自动进行merge本地仓库。Pull：从远程获取最新版本到本地，并自动进行merge本地仓库操作。Switch To：切换/创建切换 分支。Merge：merge操作。Reset：重置提交操作。Show in Histroy：查看提交日志。4.3 eclipse中git信息配置点击导航菜单栏Windows，选择Prefere

8、nces，左侧搜索框输入git，点击搜索到的git节点。点击展开git节点。点击Configuration节点。如果按照前面步骤设置了git的用户信息，在右侧面板中就可以看到用户的相关信息。否则，可以在此处以Key、value的形式添加用户信息。4.4导入远程的git工程到工作空间在project explorer区域，右键选择import-import。点击展开git节点，选择Projects from Git（with smart import），点击Next，选择Clone URI，粘贴项目主页复制的git project的url，点击Next，进入Branch Selection，点击

9、Next，在Local Destination页面，选择Directory（即你在本地的工程存储路径），点击Next，进行导入信息展示页面，点击Finish即可。4.5 git添加文件操作本地项目中新增/修改/删除文件后，选中工程，右键选择Team，选择Add to Index，即将修改的文件添加到暂存区（也可以在commit操作时进行Add to Index操作）。4.6 git提交文件操作选中工程，右键选择Team，选择Commit，eclipse显示Git Staging面板。左侧分为上下两个部分。上本分为未暂存的文件（可选中该区域的文件，右键点击Add to Index，将修改的文件添

10、加到暂存区），下部分为暂存的（待提交）文件（选中该区域的某个文件，双击可对比该文件上个版本与工作空间的内容）。在右侧Commit Message区域的textarea中输入提交信息，点击Commit，即可提交到本地git仓库中。（点击Commit and Push，即可提交到本地git仓库以及push到服务器git仓库中）4.7 git重置提交文件操作若提交文件后，发现提交的问题不正确，可重置提交操作。选中工程（注：最好备份当前更新的文件，否则reset造成本地文件丢失），右键选择Team，选择Reset，选择要回退到的分支（Local节点为当前本地分支，后面带有commit id缩写；Ref

11、erences为当前各HEAD指针指向的版本，后面带有commit id缩写；Remote Tracking为git远程仓库分支，后面带有commit id缩写），点击reset，当前工作空间内容即reset到对应的版本了。reset操作时有三种操作类型可选：Soft、Mixed、Hard。Soft：仅回退commit信息（HEAD 指针），不回退暂存区（Index）和工作区（Working Directory 文件）源码。Mixed：回退commit信息（HEAD 指针）和暂存区（Index），只保留工作区（Working Directory 文件）源码。Hard：所有更改都将恢复到所选分支

12、/标记/Commit版本。工作区（Working Directory 文件）源码会变为上一个Commit版本的内容，未提交的更改都将丢失，因此该操作必须确认。4.8 git推送文件操作选中工程，右键选择Team，选择Push to Upstream即可。4.9查看提交历史记录选中工程，右键选择Team，选择Show in History。4.10创建分支1，选中工程，右键选择Team，选择选择 Switch to，选择New branch，弹出创建分支页面。2，输入工程名称（选择Checkout new branch，即可在创建分支后，将当前工作空间切换到该分支），点击Finish。4.11

13、Merge分支切换到要Merge的目标分支上，选中工程，右键选择Team，选择Merge，展开Remote Tracking，选择想要Merge的分支，点击Merge。4.12通过gitlab发送merge请求到master1，选择对应的project，点击branches。点击对应分支后面的 Merge Request按钮。2，在New Merge Request页面输入相关内容。注意：写清楚description（merge描述），assignee（merge操作对象），source branch，target branch。3，点击Submit merge request。即完成了mer

14、ge 请求操作，进入Merge request展示页面。4.13通过gitlab接受merge请求1，接收merge请求的用户，会收到通知（当然在project中的Merge Requests后面也会显示merge请求数量）。点击通知按钮，进入消息列表。2，点击Done，开始处理。选择Done选项卡，点击merge请求消息，进入merge请求操作页面。3，点击Commits选项卡，即可看到本次merge的提交记录。4，点击右侧的commit id 的缩写。即可查看本次提交的内容。5，确定可以merge后，点击Accpet Merge Request，即开始进行merge操作。6，merge完成

15、后，显示相关消息。7，进入工作空间，进入merge的目标分支，进行pull操作，再查看history，即可看到merge日志。4.14 merge冲突如果当前merge请求的内容存在冲突，则进入merge页面后，会显示当前merge请求存在冲突。4.15解决merge冲突根据页面提示，需要在本地解决冲突，或者在本地进行merge操作。点击Merge locally按钮，就可以看到相关命令指示操作。1， 从远程获取最新版本到本地仓库，并检出merge的源分支（如上图为：future208）。2， 切换到merge的目标分支（如上图为：master）。3， 在eclipse IDE中进行merge。 4， 到本地资源文件或IDE中打开冲突的文件。5，在本地资源文件或IDE中解决冲突的文件。6，将最新修改推送到服务器。7，merge完成。通过查看git日志和gitlab merge request页面即可查看。