一、Git入门
Git 是一个分布式版本控制系统，广泛用于软件开发中管理源代码。以下是 Git 的基础使用指南。
1. 安装 Git
-
Windows: 下载 Git for Windows
-
macOS: 使用 Homebrew (
brew install git) 或下载安装包 -
Linux: 使用包管理器安装（如
sudo apt-get install git）
安装后验证：
bash
git --version2. 初始配置
设置用户名和邮箱（用于提交记录）：
bash
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"3. 创建新仓库
bash
mkdir project-name
cd project-name
git init4. 基本工作流程
添加文件到暂存区
bash
git add filename # 添加特定文件
git add . # 添加所有更改提交更改
bash
git commit -m "描述性的提交信息"查看状态
bash
git status查看提交历史
bash
git log5. 分支管理
创建分支
bash
git branch branch-name切换分支
bash
git checkout branch-name或创建并切换：
bash
git checkout -b branch-name合并分支
bash
git checkout main
git merge branch-name6. 远程仓库
克隆现有仓库
bash
git clone https://github.com/user/repo.git克隆现有特定分支
要克隆 Git 仓库的特定分支而不是默认分支（通常是 main 或 master），你可以使用以下几种方法：
方法一：克隆后切换分支
bash
git clone <仓库URL>
cd <仓库目录>
git checkout <分支名>方法二：克隆时指定分支（一步完成）
bash
git clone -b <分支名> --single-branch <仓库URL>参数说明：
-b <分支名> 或 --branch <分支名>：指定要克隆的分支
--single-branch：只克隆指定分支，不克隆其他分支（可选）
示例
克隆名为 "develop" 的分支：
bash
git clone -b develop https://github.com/user/repo.git如果只想克隆该分支而不获取其他分支的历史：
bash
git clone -b develop --single-branch https://github.com/user/repo.git注意事项
如果不使用 --single-branch，所有分支的元数据仍会被下载，你可以在本地切换到任何分支
使用 --single-branch 可以节省时间和带宽，特别是对于大型仓库
如果你想以后获取其他分支，可以使用 git remote set-branches origin '*' 然后 git fetch
添加远程仓库
bash
git remote add origin https://github.com/user/repo.git 用于将本地仓库与远程仓库关联起来。
详细命令解释：
git remote
Git 的远程仓库管理命令，用于添加、删除或修改远程仓库的引用。
add
表示要添加一个新的远程仓库。
origin
远程仓库的默认名称（别名），这是 Git 的惯例名称，你也可以用其他名字（如 upstream）。
https://github.com/user/repo.git
远程仓库的 URL（HTTPS 协议格式）。如果是 SSH 协议，地址类似：
git@github.com:user/repo.git
推送更改
bash
git push -u origin main详细命令解释：
git push
将本地代码推送到远程仓库。
-u（或 --set-upstream）
将本地分支与远程分支关联（建立跟踪关系）。后续在该分支使用 git push 或 git pull 时，无需再指定远程分支。
origin
远程仓库的默认名称（通常是第一次 git clone 时的仓库地址的别名）。
main
本地分支名（Git 默认主分支名，早期可能叫 master，现在多为 main）。
作用：
将本地 main 分支的提交推送到远程仓库 origin 的同名分支（即 origin/main）。
建立关联后，下次直接运行 git push 或 git pull 即可，无需再写完整命令。
注意：
如果远程分支名不同（例如远程叫 master）
git push -u origin main:master拉取更新
bash
git pull origin main如何更新 Git 子模块
Git 子模块更新通常涉及几个步骤，以下是更新子模块的不同方法：
1）. 初始克隆时包含子模块
bash
git clone --recurse-submodules <主仓库URL>这会克隆主仓库及其所有子模块。
2）. 克隆后初始化并更新子模块
如果已经克隆了主仓库但没有子模块：
bash
git submodule init # 初始化子模块配置
git submodule update # 检出子模块的指定提交或者使用组合命令：
bash
git submodule update --init3）. 递归更新子模块
如果子模块还包含子模块：
bash
git submodule update --init --recursive4）. 拉取最新代码并更新子模块
bash
git pull
git submodule update --remote --recursive--remote 参数会让子模块跟踪远程分支的最新提交，而不是主仓库记录的提交。
5）. 更新特定子模块
bash
git submodule update --remote <子模块路径>6）. 将子模块更新到最新提交
bash
cd <子模块目录>
git checkout main # 或其他分支
git pull
cd ..
git add <子模块目录>
git commit -m "更新子模块到最新版本"常见问题解决
如果遇到子模块更新问题，可以尝试：
bash
git submodule sync # 同步子模块URL
git submodule update --force # 强制更新7. 常用命令速查
| 命令 | 描述 |
|---|---|
git diff | 查看未暂存的更改 |
git reset filename | 取消暂存文件 |
git checkout -- filename | 丢弃工作目录中的更改 |
git stash | 临时保存未提交的更改 |
git tag | 管理标签 |
8. 最佳实践
-
提交信息要清晰、具体
-
频繁提交小改动
-
使用分支开发新功能
-
定期从主分支拉取更新
-
推送前先解决合并冲突
二、实战（上传代码到gitee）
在Gitee（中国版的GitHub）上上传代码是一个简单的过程。以下是详细的步骤，帮助你完成这一任务：
1. 创建仓库
首先，确保你已经有一个Gitee账号。如果没有，需要先注册一个。
登录你的Gitee账号。
点击右上角的+号，选择新建仓库。
填写仓库的名称、描述等信息。
选择是否初始化README文件（通常建议选择）。
点击创建仓库。
2. 准备本地代码
确保你的代码已经存储在本地的一个文件夹中。例如，你的项目文件夹名为MyProject。
3. 在本地初始化Git
打开命令行工具（如Git Bash、Terminal等），导航到你的项目文件夹：
cd path/to/MyProject然后，初始化Git仓库：
git init4. 添加远程仓库地址
在Gitee上创建好仓库后，会看到一个地址（例如https://gitee.com/yourusername/myrepository.git）。在你的项目文件夹中，执行以下命令来添加这个远程仓库：
git remote add origin https://gitee.com/yourusername/myrepository.git5. 添加文件到Git并提交
将你的代码文件添加到Git仓库中，并提交：
git add . # 添加所有文件到暂存区
git commit -m "Initial commit" # 提交更改，并添加提交信息6. 推送到Gitee
最后，将你的本地仓库推送到Gitee：
git push -u origin master # 或者使用 git push -u origin main，取决于你的默认分支名称如果https时，Git 会要求输入 Gitee 的账号密码（或 token）。使用 SSH 密钥认证，无需每次输入密码（需提前配置 SSH 密钥）。
如果失败，可以使用force强制推送。
git push --force -u origin master7. 验证上传结果
打开你的Gitee仓库页面，刷新页面，你应该能看到你的代码已经成功上传。
