> For the complete documentation index, see [llms.txt](https://euclid-jie.gitbook.io/euclid_jie_s_book/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://euclid-jie.gitbook.io/euclid_jie_s_book/git-xiang-guan.md). # Git 记录使用Git过程中的总结，主要包括Git命令，GIt与各种IDE的配置，Git与GitHub远程仓库连接 当然使用Git的前提是，设置了SHH，教程[指路](/euclid_jie_s_book/ssh-jie-shao.md) ### Git配置 Git官网下载并安装，配置邮箱、 * 配置邮箱和姓名 ```shell git config --global user.email "youremail" git config --global user.name "yourname" ``` * 查看邮箱和姓名 ```shell git config --global user.email git config --global user.name ``` ### Git基础命令 * 初始化一个仓库 ```bash git init ``` * 查看远程信息 ```bash git remote -v # 查看远程仓库地址 git remote # 查看远程仓库分支 git remote show origin # 查看某个分支的具体信息 ``` * 储存 不常用，主要是为了处理冲突 ```bash git stash save "本地缓存内容标识" # 创建储存 git stash list # 查看有哪些储存 git stash clear # 清除所有储存 git stash push -m "test stash" -p # -p进入交互式窗口, 指定部分文件的部分内容进行stash ``` * 添加文件 ```bash git add git add . # 添加所有新增文件 git add --patch # 添加部分 ``` > 以下内容来自 Claude > > * `y` - 暂存这个块 > * `n` - 不暂存这个块 > * `q` - 退出,不暂存这个块及之后的块 > * `a` - 暂存这个块及之后的所有块 > * `d` - 不暂存这个块及之后的所有块 > * `j` - 暂存这个块及向下移动到下一个未暂存块 > * `J` - 暂存这个块及放弃暂存区的其余部分 > * `g` - 选择一个块边界中的另一个块 > * `/` - 搜索一个块匹配的模式 > * `s` - 拆分这个块为更小的块 > * `e` - 手动编辑这个块的内容 > * `?` - 显示列表帮助 * 查看被管理的所有文件 ```bash git ls-files ``` 查看是否有变动 ``` git status git status -s # 简要查看 git diff # 查看具体文件内容变化 ``` * `pick` 将其他分支上的提交，`pick`到当前分支上，相当于，`copy`了文件的变动到当前分支 ```bash git cherry-pick commit1_hash -n # pick commit 1, -n 控制了只pick但是不commit git cherry-pick commit1_hash commit2_hash # pick 两个提交 git cherry-pick commit1_hash..commit5_hash # pick commit1 至 commit5 间的多个提交 ``` * 提交 与`Pycharm`不同，提交前都需要`add` ```bash git commit -m "commit by bash" git commit --amend -m "commit by bash" # 修正提交 ``` * 绑定远程仓库，需要先配置SSH并在远程创建好仓库 ```bash git remote add origin git@github.com:[yourGitHubName]/[yourRepositories].git ``` 或者请在GitHub创建完仓库后，自己观察页面，上述代码可以直接复制到 * 推送 > 如果远程没有这个分支，第二种方式 > > 第三种方式会将remote倒退至hash commit ```bash git push git push --set-upstream github dev/jie/htsec_feature git push github hash:branch_name -f ``` * 查看提交记录 > git reflog 显示的内容更多 ```bash git log git reflog ``` ### Git显示中文乱码 `step1`设置`config`中的引用路径 ```bash git config --global core.quotepath false ``` 将终端设置为`utf-8`编码 `step2`在`git bash`的界面中右击空白处，弹出菜单，选择`选项->文本->本地Locale`，设置为`zh_CN`，而旁边的字符集选框选为`UTF-8`。 ### Git使用新设备打开时，无法显示提交记录 ```shell git config --global --add safe.directory F:/GitHub/my-project git config --global --add safe.directory * ``` ### Git无法Push，显示超时 ```shell Failed to connect to github.com port 443:connection timed out ``` 需要删除`git`的全局代理后重新`Push` ```shell git config --global --unset http.proxy git config --global --unset https.proxy ``` 有时候是因为SSL证书问题，需执行 ```shell git config --global http.sslVerify "false" ``` 一般来说，如果实在解决不了的话，可以挂梯子后使用github desktop解决 #### 建议从以下几个方面排查 * 检查协议 一般远程仓库的连接有两种方式，git或者http，直接检测远程链接即可 ``` git remote -v ``` 返回值开头是啥就是啥协议 * 不同协议超时有不同的排除流程 * git对应的是ssh协议，检查自己的电脑的ssh私钥和github网站上的公钥是否配置好 * http协议则是因为墙，试试代理 * 建议使用git ssh协议，兼容性更好 ## 使用Pycharm ### 创建Git仓库 #### 本地创建 `Pycharm`的`VCS`支持一键创建，就没啥好说的了，一般情况下，是需要使用git命令行创建的，命令好像是 `git init`，因为git我是好久以前就配置好了的，`ssh`那些都弄好了，所以就记得不太清楚了，在此就只写目前我的工作流 #### 远程创建 此前一直使用`GitHub`，我也是它的忠实用户，但是无奈某些原因连接实在是不稳定，所以使用`Gitee`临时替代。`Pycharm`默认的就是`GitHub`，所以直接在`Git`窗口中登录`Github`账号，然后设置一下远程仓库的名字就好了，因为我已经在`Github`中添加了电脑的`ssh`，所以后续的推送都很顺利 `Gitee`与`GitHub`就是大同小异的，也就是登录、创建再提交就成 ### 分享本地项目至远程 使用`Pycharm`可以很方便分享，根据提示做好仓库命名和介绍就成，另外要注意可以在在`.git`中的`config`文件中修改`url`为`https://{username}:{password}@github{username}/project.git`格式，这样的话可以避免推送的时候让你再次登录 ### 提交与推送 这块就是勾选要提交的文件，然后写一些说明就提交就好了，一段时间后我会推送到远程 一般最开始推送的时候，我会不推送导出数据文件，以及一些设置文件，这样在最后提交项目的时候，就可以直接从`GitHub`或者`Gitee`上下载压缩包，会比较方便一点，因为确实提交项目的时候那些个人设置文件，一起运行程序的导出文件都是不必要的，会使得压缩包冗大，设置文件甚至出现不知名错误 一旦推送后，最好不要进行修正，因为会导致需要先拉取远程更新，早进行提交推送，是`Git`流程出现合并分支的记录（主要是不美观） ### 分支与合并 这个功能是我新学的，很好用，在已有稳定版本的情况下，如果想做一些尝试性的修改，那么创建一个分支，在分支上修改并测试稳定后，将分支合并到原分支上，然后删除分支就可以了，这个功能真是让我赞不绝口 ### 删除分支 本地的分支合并后，就可以直接删除了，但是远程的分支必须保证该分支表示`master`（主要）分支后，才能删除 ，如果是主要分支，那需要在`GitHub`或者`Gitee`上进入该仓库进行修改后再删除 ### Git中的一些命名 ``` 一般命名是：仓库名/分支名，一般本地仓库不标注直接是分支名master，对应的远程仓库一般叫：origin/master，当然这些就只是名字，是为了便于我们区分，因为使用时间较短，目前我还没有形成自己的命名标准。 ``` 新分支的时候，可以根据分支需要进行命名（可以为汉字） ## 使用VsCode 近期的工作都在Vscode中开展, 主要是连接服务器开发, Vscode更方便, 顺便记录一下VsCode中的git管理 ### Git Graph插件 > VsCode中热度最大的git插件应该是git lens, 但是需要收费, Git Graph是一款非常类似Pycharm自带git管理的插件 得益于Git Graph这款插件, 使得在VsCode中进行git管理, 非常方便。有非常清晰的可视化分支, 并可以通过右键方式进行诸如, checkout, merge, rebase等操作 ### merge or rebase ? > merge 和 rebase为git中进行分支合并时非常常见的操作, 网络上各种介绍很多, 不再班门弄斧 merge 和 rebase有着不同的常见, rebase会使得git历史呈现一条直线. 尽可能整洁, 并在PR时不会冲突(因为在rebase中已经提前解决); 而merge会使得分支溯源更为容易, 会清晰记录分支的走向 对我个人而言, 公司的项目多人参与且contribute较为严格, 使用rebase; 个人项目往往各种奇思妙想比较多, 故使用merge ### 如何借助Git Graph进行merge ? > 定心丸: 只要不push到远程, 无论何种操作都能通过reset复原, 可大胆操作 > > 后悔药: 如果在进行merge, 或者正在解决冲突途中, 想退出, 执行`git merge --abort`即可 确保自己处于master分支上, 选择dev分支右键进行`merge into current branch`, 如果有冲突(出现合并冲突), 则解决冲突, 完成后实现merge ### 如何借助Git Graph进行rebase ? > 与merge一样, 仍旧有定心丸和后悔药可以吃, rebase途中退出, 执行`git rebase --abort`即可 确保自己处于dev分支上, 选择master分支右键进行`rebase current branch on Branch`, 一般来说都会遇到冲突, 有冲突解决冲突即可, 完成后实现rebase 参数-i可以在交互窗口中实现pick ## tipis ### 后悔药`reflog` 只要没被`push`到远程，本地的所有操作都可以通过`reflog`进行恢复 * 查看操作历史记录 ```bash git reflog ``` > demo中展示了此repo的最近几条操作记录，寻找出你需要回退的记录对应的hash头 ```bash 0c326f8 (HEAD -> dev/Jie/half_hour_features) HEAD@{0}: reset: moving to 0c326f8 6426675 HEAD@{1}: reset: moving to 6426675 cd44d32 (github/test, github/master, github/HEAD, master) HEAD@{2}: reset: moving to cd44d32 6426675 HEAD@{3}: reset: moving to HEAD 6426675 HEAD@{4}: rebase (finish): returning to refs/heads/dev/Jie/half_hour_features 6426675 HEAD@{5}: rebase (pick): add AfterFog ClimbPeak 80f1155 HEAD@{6}: rebase (squash): clear code and add unittest fe39abc HEAD@{7}: rebase (squash): # 这是一个 2 个提交的组合。 d3a491e HEAD@{8}: rebase (start): checkout master 2388e09 HEAD@{9}: rebase (finish): returning to refs/heads/dev/Jie/half_hour_features 2388e09 HEAD@{10}: rebase (pick): add AfterFog ClimbPeak 37a1991 HEAD@{11}: rebase (pick): fix distance to high 5046792 HEAD@{12}: rebase (pick): add real_stats, corr_price_volume, large_volume d3a491e HEAD@{13}: rebase (pick): clear code and add unittest 274dd93 HEAD@{14}: rebase (pick): add DeriveHalfHourFeatureFromTickTradeMinBar f9797f5 HEAD@{15}: rebase (pick): init branch ``` * 进行回退 > 需要说明的是，进行回退后，将回到此条操作结束后的状态 ```bash git reset --hard 6426675 ``` ### PR更新 > 提交了PR，还没来得及merge, master却发生了更新, 怎么办 将PR rebase 到 remote master ```base git pull --rebase origin master ``` force 提交 ```base git push -u github impl_ht_rpt_half_hour -f ``` 其他机器进行`pull` ```bash git pull --rebase ``` ### 其他 * 修改项目文件的*\~.git\config*中的远程地址，可以直接修改http协议为ssh协议 * 远端已删除，但是本地还显示有，需要对照`remote`进行修建 ```bash git remote prune origin --dry -run ``` * 关于 Head Orgin 等 [细读 Git | 让你弄懂 origin、HEAD、FETCH\_HEAD 相关内容-阿里云开发者社区 (aliyun.com)](https://developer.aliyun.com/article/919354) * 关于 git submodule [git submodule 命令 | 菜鸟教程 (runoob.com)](https://www.runoob.com/git/git-submodule.html)