Version Control

base

# git 帮助命令
git xxx -h    # git branch -h

config manager

• gitconfig
  

  # 查看当前仓库的git config设置
  git config --list # 查看所有配置
  
  # config 配置文件
  # System .gitconfig 路径
  # Windows    --> TODO
  # OSX/Linux  --> /etc/gitconfig
  git config --system user.name "wolfand11"
  git config --system -l # 查看系统配置
  
  # Global .gitconfig 路径
  # Windows    --> ~/.gitconfig
  # OSX/Linux  --> TODO
  git config --global user.name "wolfand11"
  git config --global -l # 查看用户配置
  git config --global --unset user.name
  
  # 当前仓库 gitconfig 路径为 ./.git/conifg
  git config user.name "guodong"
  git config --local -l # 查看当前 git 仓库的配置
  git config --local -e # 打开配置文件
  

• gitignore
  
  • 忽略 StudyProjects 中 Qt Build 目录
    

    ## Qt Project
    build-**-Debug/
    

  • 参考资料
    
    • https://git-scm.com/docs/gitignore
      
    • https://www.toptal.com/developers/gitignore
      

project manager

content manager

• 取消修改
  
  • 总结
    
    • 工作区
      

      git clean -f ./ 取消工作区所有新增文件
      git checkout ./ 取消工作区所有修改
      

    • 暂存区
      

      git restore –staged . 将暂存区文件全部放会工作区
      

    • 本地仓库
      

      git reset –hard HEAD 取消工作区 暂存区 本地仓库的修改
      

  • clean
    

    git clean 的对象为 untracked files，也就是在工作区新建，但还未执行 git add 命令提交到暂存区的文件或目录
    

    git clean -n                   # 干跑模式，可以列出哪些文件会被清除，但不会列出哪些目录会被清除。
    git clean -f <files>           # 若指定文件，则该文件被清除，若不指定文件，则所有未被提交到暂存区的文件都被清除。
    git clean -df <files> <dirs>   # 若指定目录，则该目录被清除，若不指定目录，则所有未被提交到暂存区的目录都被清除
    
    git clean -ndf <files or dirs> # 干跑模式，列出哪些目录 文件会被清除
    

  • restore
    

    该命令有如下两种形式：
    git restore –stage <file>
    git restore <file>
    

    1. 文件在暂存区且未作修改的情况
       使用 git restore –staged <file> 把文件从暂存区移动到工作区，即文件不被追踪；
       
    2. 文件在暂存区且已经修改的情况
       使用 git restore –staged <file> 把文件从暂存区移动到工作区，且不会撤销修改的内容；
       使用 git restore <file> 文件仍在暂存区且会撤销文件修改的内容；
       
    3. 文件在本地代码库已经修改的情况
       使用 git add <file> 把文件重新放到暂存区，且保留文件的修改；
       使用 git restore <file> 文件仍在本地代码库且会撤销文件的修改；
       

    总结：
    对于 git restore <file>命令，会撤销文件的修改，使文件恢复到暂存区或本地代码库（取决于文件在修改前的状态）
    对于 git restore –staged <file>命令，把文件从暂存区撤回到工作区，保留文件最后一次修改的内容
    

  • checkout
    

    git checkout 的作用：同时恢复工作区和暂存区, 参数是否带有文件名时表现不一致, 不带文件名时间
    

    1. git checkout [xxx branch]
       
       • 改变 HEAD 的指向到指定 branch
         
       • 更新工作区的内容
         
    2. git checkout [xxx file]
       
       • 将当前 暂存区 的文件覆盖到工作区
         
    3. git checkout [xxx branch] [file]
       
  • rm
    

    git rm 的作用： 删除工作区文件，并且将这次删除放入暂存区。git rm 等价于 rm xxx && git add .
    

      git rm xxx              # 作用: 删除工作区文件，并且将这次删除放入暂存区
                              # 注意: 要删除的文件是没有修改过的，就是说和当前版本库文件的内容相同。
      git rm -f xxx           # 作用: 删除工作区和暂存区文件，并且将这次删除放入暂存区。
                              # 注意: 要删除的文件已经修改过，就是说和当前版本库文件的内容不同。
      git rm --cached xxx     # 作用: 删除暂存区文件，但保留工作区的文件，并且将这次删除放入暂存区
    

  • reset
    

    git reset 的命令：（–hard、–soft 与–mixed；主要用于工作区、暂存区、本地仓库三个区域的文件提交撤回。Tips: –mixed 为默认方式。
    git reset 的作用：是修改 HEAD 的位置，即将 HEAD 指向的位置改变为之前存在的某个版本。
    git reset 的场景：如果想恢复到之前某个提交的版本，且那个版本之后提交的版本我们都不要了，就可以用这种方法。
    

    git reset –soft xxx(commit 操作的哈希 ID) 用于将本地仓库的文件撤回暂存区的操作
    git reset –mixed xxx(commit 操作的哈希 ID) 用于将本地仓库文件撤回至工作区的操作
    git reset –hard xxx(commit 操作的哈希 ID) 用于将工作区、暂存区、本地仓库的所有提交的文件全都撤销（包括工作区文件，会删除）（回收站也没有哦）
    

    
    

  • revert
    

    git revert 的命令：-n、-m。
    git revert 的作用：是一种反做命令,是用于“反做”某一个版本，以达到撤销该版本的修改的目的。
    git revert 的场景：如果我们想撤销之前的某一版本，但是又想保留该目标版本后面的版本，记录下这整个版本变动流程，就可以用这种方法。
    

      git show bd86846                                    # 显示commit信息
      # commit bd868465569400a6b9408050643e5949e8f2b8f5
      # Merge: ba25a9d 1c7036f
    
      git revert -n xxx(commit 操作的哈希 ID)           # -n 表示不自动commit
      git revert xxx(commit 操作的哈希 ID) -m [1|2]     # -m 表示revert的是一个 merge commit，-m 选项接收的参数是一个数字，数字取值为 1 和 2，也就是 commit信息中Merge信息行里面列出来的第一个commit还是第二个commit
    

    s+attr_html: :width 512px
    
    

    • https://segmentfault.com/a/1190000012897697
      
  • 参考资料
    
    • https://www.atlassian.com/git/tutorials/resetting-checking-out-and-reverting
      
    • https://sohslx.cn/git/4.html
      
    • https://kirakirazone.com/2018/12/22/git-clean-rm-reset-revert-checkout%E7%94%A8%E6%B3%95%E5%92%8C%E5%8C%BA%E5%88%AB/
      
• merge
  
  • dev 合并到 master 上
    

    git checkout dev
    git pull
    git checkout master
    git merge dev
    git push -u origin master
    

  • 将 XD merge 到 PP_URP
    

    # 如果本地没有xd分支，则checkout xd分支到本地
    # 如果本地已经有 xd 分支，则切换到本地xd分支
    git checkout xd
    # 更新xd分支
    git pull
    # 切换到 XD_URP_PP分支
    git checkout XD_URP_PP
    # 更新 XD_URP_PP 分支
    git pull
    # 将xd分支merge到XD_URP_PP
    git merge xd
    # 查看是否有冲突 merge冲突
    # 如果 .unity .asset .prefab .mat等资源文件冲突，使用下面命令修复冲突
    git mergetool
    
    ################################################################
    # 测试修改的功能是否正常
    
    ################################################################
    # 提交merge
    git push
    
    # create merge request
    

• log
  
  • 查看某个人提交的日志
    

      git log --author="guodong"                 # 查看guodong的提交日志
      git log --author="guodong" --oneline       # 查看guodong的提交日志，日志内容只显示一行
    

  • 查看某文件的修改日志
    

      # 查看所有修改日志
      git log filename
      # 查看最近2条修改日志
      git log -n 2 filename
    

    • https://blog.csdn.net/sea_snow/article/details/91430247
      
  • 查看某个 revision 日志
    

    git show ad08ad960b1d42d13c66b66b2c2e02a6d960e2bd
    

    • https://stackoverflow.com/questions/4082126/git-log-of-a-single-revision/4082188#4082188
      

从 My_v3_1 创建 My_v4_0 分支

  # 获得 My_v3_1 分支
  git clone -b My_v3_1 https://github.com/wolfand11/MyCocosBuilder ./My_v4_0_MyCocosBuilder

  # 以 My_v3_1为基础创建 My_v4_0分支 并切换到My_v4_0
  git checkout -b My_v4_0
  # or 创建 My_v4_0 然后再切换到My_v4_0
  git branch My_v4_0
  git checkout My_v4_0

  # 查看远程 remote name
  git remote -v

  # 将本地 My_v4_0分支push到远程
  git push remote_name My_v4_0:My_v4_0

  # 删除本地My_v3_1 分支
  git branch -d My_v3_1

  # Tips: 提交时发现 本地和远程分支没有关联，可以使用如下命令将两者关联
  git push --set-upstream origin My_v4_0

更新自己 fork 出来的源代码

问题说明：
从 https://github.com/cocos2d/CocosBuilder fork 出来一份 CocosBuilder 的源代码 MyCocosBuilder，
过一段时间以后，原来的 CocosBuilder 的 develop 分支有更新，需要将 CocosBuilder/develop 的更新添加到 MyCocosBuilder/develop 中。
操作方法：
(1)获得最新 MyCocosBuilder/develop 源代码
git clone -b develop https://github.com/wolfand11/MyCocosBuilder ./MyCocosBuilder_develop
cd MyCocosBuilder
git submodule update --init --recursive
(2)添加新的远程库
执行命令 git remote add real_origin https://github.com/cocos2d/CocosBuilder
(3)获得 real_origin/develop
git fetch real_origin develop
(4)Merge 修改到本地代码
git merge real_origin/develop
(5)更新 origin/develop 分支
push 本地的 develop 分支到 origin/develop 分支。即 https://github.com/wolfand11/MyCocosBuilder.git 的 develop 分支

在自己 fork 出来的源代码中，以最新源码为基础创建新分支

问题说明：
从 https://github.com/cocos2d/CocosBuilder fork 出来一份 CocosBuilder 的源代码 MyCocosBuilder，
并且在 MyCocosBuilder/develop 分支的基础上添加自己的分支 v2_0，.过一段时间以后，需要添加分支 MyCocosBuilder/My_v3_0，
并且要求 My_v3_0 以最新的 CocosBuilder/develop(或者 CocosBuilder/master)为基础。
操作方法：
(1)获得最新 CocosBuilder/develop 源代码
git clone -b develop git://github.com/cocos2d/CocosBuilder.git ./MyCocosBuilder/CocosBuilder_v3_0
cd MyCocosBuilder/CocosBuilder_v3_0
git submodule update --init --recursive
(2)添加新的远程库
执行命令 git remote add My_v3_0 https://github.com/wolfand11/MyCocosBuilder
(3)将本地 develop 分支 push 到 my_resource
git push My_v3_0 develop:My_v3_0

将指定文件回滚到之前某个版本

  # 查看 index.php文件的提交记录，获得版本hash
  git log <filename1>

  # checkout 出指定版本的filename1 filename2 文件
  git checkout <hash> <filename1> <filename2>

  # commit 对filename1 filename2的修改
  git commit -m "revert filename1 filename2 to xxxxxx version"

  # push
  git push