# LoopyModify

**Repository Path**: pku-xsr/LoopyModify

## Basic Information

- **Project Name**: LoopyModify
- **Description**: 在图形化界面上，通过手动或自动的方式，处理LoopyCuts生成的.obj和包含Loop信息的.txt文件，使得对Loop内容进行修正
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-09-20
- **Last Updated**: 2024-10-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Git使用说明

### 1 代码管理工具介绍

#### 1.1 Gitee介绍

Gitee 是中国的一款基于 Git 的代码托管平台，由开源中国开发。它提供了版本控制、项目协作、代码审查等功能，类似 GitHub，但更加本地化，适合中国开发者使用。由于服务器位于中国，Gitee 在网络访问速度和使用体验上有显著优势。Gitee分为个人版、企业版和高校版，个人版只支持5人以内的项目，企业版需要付费，高校版需要认证。



#### 1.2 Git介绍

Git是分布式的版本控制系统，使用它管理项目的好处有：离线操作、多副本备份、并行开发、代码隔离、每次变更可追溯和回滚、代码审查方便、解决代码冲突方便、跨平台。



#### 1.3 Gitee与Git的区别

Gitee和Git两者是不同的概念，Gitee是一个基于 Git 的托管平台，Git是底层的版本控制工具，支持开发者在本地进行代码管理，并通过平台（如 Gitee、GitHub）来团队协作。





### 2 准备工作

#### 2.1 创建gitee账号

自行在官网创建即可



#### 2.2 搭建git环境

下载git并配置自己的git用户名和邮箱，下载完成后，在任意文件夹打开命令行，输入git --version验证是否安装完成

[windows安装git（全网最详细，保姆教程）-CSDN博客](https://blog.csdn.net/weixin_42242910/article/details/136297201#:~:text=本文详细介绍了如何在)



#### 2.3 管理项目成员

管理员将gitee用户添加到项目成员中，并设置权限（免费版一个项目限5个成员）

![输入图片说明](docImage/cfd6645dce3dd6c701cf5e66a8c8554.png)



### 3 项目开发

#### 3.1 拉取代码到本地进行开发

通过http的形式将代码拉取到本地文件夹。在本地打开命令行，输入以下指令  
![输入图片说明](docImage/7ce16dbdd873eacd05d8821639c5d2a.png)
  
![输入图片说明](docImage/7e602b317f73a551cfa580e1d623e02.png)



这里推荐用vscode或者其他编译器进行访问。尽量将.git所在的父文件夹视为整体项目，用vscode打开，之后方便直接用vscode的git插件进行访问  
![输入图片说明](docImage/079611a6a9bcf4a9832f0494c74758f.png)  


![输入图片说明](docImage/b414a9da7c2a5f4f4a4c77342ee2869.png)  




#### 3.2 提交更改

##### 3.2.1 git add 暂存更改  

![输入图片说明](docImage/%E5%BE%AE%E4%BF%A1%E6%88%AA%E5%9B%BE_20240920121137.png)  



##### 3.2.2 git commit提交更改（这一步要加上commit的文字描述）  
![输入图片说明](docImage/%E5%BE%AE%E4%BF%A1%E6%88%AA%E5%9B%BE_20240920121524.png)  


##### 3.2.3 git push推送到当前分支  

![输入图片说明](docImage/%E5%BE%AE%E4%BF%A1%E6%88%AA%E5%9B%BE_20240920121540.png)  





##### 3.2.4 在代码管理工具上（我们在gitee的项目主页），提交pr并审核合并
 
![输入图片说明](docImage/caecc331c252c73dfbd4eee2a164589.png)




##### 3.2.5 用命令行的情况  

![输入图片说明](docImage/801b21dd669d56ed5c9ee2e8e59a2bf.png)  




##### 3.2.6  一般提交前，要git pull一下，如果需要合并主干，就git pull 主干。git pull的时候可能会出现代码文件冲突，需要手动逐行更改  

![输入图片说明](docImage/3e072e58fe0da77cc260dc790980911.png)  





### 4 注意事项

#### 4.1 项目管理的核心——分支和 Pull Request（PR）

在管理项目时，如果所有开发人员都在一个代码分支（如 master）上工作，多人同时修改代码可能导致混乱。一个人的修改可能会影响另一个人的功能开发，并且缺乏一个统一的原始版本。为了解决这些问题，我们使用**分支**和**Pull Request**（PR）机制来更好地管理和审核代码。  

ps：一个包含多个小项目的大项目可以放在一个代码库里，每次拉取代码可以根据不同级别和不同内容的文件夹进行选择性拉取。  



##### 4.1.1 分支结构

当开发者需要对某个功能进行开发时，首先应该在主干 master 上创建一个**新分支**。分支是从主干延伸出来的，类似于河流中的支流。开发者可以在这个支流（分支）上随意修改代码，而不会影响到主干和其他人的工作。  

开发完成后，开发者可以通过提交 PR，将分支上的更改合并回主干。这样，主干可以保持稳定，所有修改都可以被仔细审核和验证。  



##### 4.1.2 Pull Request（PR）

PR 是一种代码审核机制。开发者在分支上完成开发并验证代码成功后，可以发起 PR，将分支的更改提交到主干或其他分支。此时，代码管理员需要对 PR 进行审核。  

代码管理员可以使用 VS Code 的 Git 插件，或者 Git 自带的代码审核功能，逐行检查代码的修改部分。在审核通过后，PR 的内容将合并到主干中。  



##### 4.1.3 处理合并冲突

在多人协作开发中，可能会遇到**合并冲突**的问题。假设有多个开发者同时在不同的分支上工作，一个开发者率先将代码提交合并到主干，此时主干的代码已经更新。另一个开发者在提交 PR 前，必须先将主干的最新代码**合并**到自己的分支。  

这个过程通常会遇到代码冲突。开发者需要对冲突的部分进行**逐行修改**，确保自己的更改与主干上的新内容兼容。这个过程类似于管理员处理 PR 中的冲突，将分支代码更新到主干的最新版本。一旦开发者解决了冲突并更新了分支，便可以继续提交 PR，将分支合并到主干。  





#### 4.2 git底层原理

https://zhuanlan.zhihu.com/p/142289703#:~:text=%E7%AE%80%E4%BB%8B%EF%BC%9A%20%E6%9C%AC%E6%96%87%E5%B0%86%E7%B3%BB%E7%BB%9F%E5%88%86