Git工具的应用与使用手册

Git 工具的应用与使用手册

Git是一个程序员在项目协作中所必须的一项重要技能，它为开发提供了极大的便利！如果你还没有学习git，或者想学习但没有开始，那么我真心建议你现在开始！

下面的内容是我整理了我在开发当中所涉及的git开发方式与常见指令，供大家参考：

本手册基于你实际操作中遇到的所有问题整理而成，涵盖从零开始：

创建项目、关联远程仓库、日常提交、分支管理到常见问题解决的全流程。

一、准备工作：配置 Git 环境

1.1 下载安装Git Bash

下载链接（win系统）：https://git-scm.com/install/windows

其他可访问Git官网进行下载

1.2 设置用户名和邮箱（首次使用必须）

bash

1.3 设置默认分支名为 `main`（推荐，与 GitHub 保持一致）

bash

如果不设置，默认分支名为 master，不影响使用，但推送时需要写 master:main。

二、新项目首次上传 GitHub（完整流程）

2.1 在 GitHub 网页上创建空仓库

输入仓库名称。

⚠️ 关键：不要勾选 “Add a README file”、“Add .gitignore”、“Add a license”，确保仓库完全为空。

点击 Create repository。

2.2 在本地初始化并关联

bash

2.3 添加、提交并推送

bash

三、日常提交与同步流程

3.1 标准提交流程

bash

3.2 从远程拉取最新更新

bash

3.3 查看状态和历史

bash

四、分支管理

4.1 分支操作

bash

4.2 推送到不同远程分支

bash

五、配置远程仓库地址（协议切换）

5.1 查看当前远程地址

bash

5.2 切换协议

bash

六、SSH 密钥配置（免密推送）

6.1 生成密钥（假设你的邮箱是 me@example.com）

bash

然后一路按回车（不设密码短语）。

系统会输出类似：

text

这里显示的 /c/Users/你的用户名/.ssh/id_ed25519.pub 就是你的公钥文件路径和文件名，请以这个输出为准。

6.2 复制公钥

根据上一步系统显示的实际文件名，执行对应的 cat 命令。例如系统显示的是 id_ed25519.pub，则：

bash

6.3 将终端输出的内容全部复制，粘贴到 GitHub 的 SSH Key 设置中

6.4 测试连接

bash

看到 Hi 用户名! You've successfully authenticated... 即成功。

七、常见错误与解决方案

错误现象	原因	解决方案
`src refspec main does not match any`	本地分支名与推送命令不一致	用 `git push -u origin master:main` 或先 `git branch -M main`
`Repository not found`	远程仓库不存在或名称错误	检查仓库名大小写，确保已在 GitHub 创建
`Permission denied (publickey)`	SSH 公钥未添加或地址非 SSH 格式	添加公钥，或 `git remote set-url` 改 SSH
`Failed to connect to github.com port 443`	HTTPS 网络连接问题	切换为 SSH 协议，或检查代理设置
`error: unknown non-ascii option`	提交命令格式错误	使用 `git commit -m "提交信息"`（注意 `-m`）
`Connection was reset`	网络不稳定	改用 SSH 协议
`Your local changes would be overwritten`	切换分支前有未提交修改	先 `git add .` + `git commit` 或 `git stash`

八、快速参考命令速查表

操作	命令
初始化仓库	`git init`
关联远程仓库	`git remote add origin <URL>`
添加所有文件	`git add .`
提交	`git commit -m "信息"`
推送（首次）	`git push -u origin main`
推送（后续）	`git push`
强制推送	`git push --force`
拉取更新	`git pull`
查看状态	`git status`
查看历史	`git log --oneline`
切换分支	`git checkout 分支名`
查看远程地址	`git remote -v`
修改远程地址	`git remote set-url origin <新URL>`

九、总结：最简工作流

新项目首次上传（SSH 方式）：

bash

日常提交：

bash

祝你使用 Git 顺利！😊

Git 工具的应用与使用手册

一、准备工作：配置 Git 环境

1.1 下载安装Git Bash

1.2 设置用户名和邮箱（首次使用必须）

1.3 设置默认分支名为 main（推荐，与 GitHub 保持一致）

二、新项目首次上传 GitHub（完整流程）

2.1 在 GitHub 网页上创建空仓库

2.2 在本地初始化并关联

2.3 添加、提交并推送

三、日常提交与同步流程

3.1 标准提交流程

3.2 从远程拉取最新更新

3.3 查看状态和历史

四、分支管理

4.1 分支操作

4.2 推送到不同远程分支

五、配置远程仓库地址（协议切换）

5.1 查看当前远程地址

5.2 切换协议

六、SSH 密钥配置（免密推送）

6.1 生成密钥（假设你的邮箱是 me@example.com）

6.2 复制公钥

6.3 将终端输出的内容全部复制，粘贴到 GitHub 的 SSH Key 设置中

6.4 测试连接

七、常见错误与解决方案

八、快速参考命令速查表

九、总结：最简工作流

新项目首次上传（SSH 方式）：

日常提交：

1.3 设置默认分支名为 `main`（推荐，与 GitHub 保持一致）