【Git详细使用教程】

Git 详细使用指南

---

一、Git 安装

1. Windows

   • 访问 Git 官网 下载安装包。
   • 默认选项安装，安装完成后在命令提示符或 PowerShell 输入 git --version 验证安装。

2. macOS

   • 使用 Homebrew：brew install git
   • 或下载安装包：访问 Git 官网

3. Linux (Ubuntu/Debian)

   sudo apt update && sudo apt install git
   

---

二、基础配置

1. 设置全局用户名和邮箱（提交记录会显示此信息）

   git config --list
   

---

三、本地项目初始化与提交

1. 初始化本地仓库

   cd 你的项目目录
   git init  # 创建隐藏的 .git 文件夹
   

2. 添加文件到暂存区

   git add .          # 添加所有文件
   git add 文件名     # 添加指定文件
   

3. 提交到本地仓库

   git commit -m "提交描述（如：初始化项目）"
   

---

四、关联远程仓库并同步

1. 创建远程仓库

   • 在 GitHub/Gitee/GitLab 等平台新建仓库，获取 HTTPS 或 SSH 地址（如 https://github.com/用户名/仓库名.git）。

2. 关联远程仓库

   git remote add origin 远程仓库地址
   

3. 首次推送代码

   git branch -M main      # 将默认分支重命名为 main（可选）
   git push -u origin main # -u 参数绑定默认推送目标
   

4. 后续同步更新

   git add .                # 添加修改
   git commit -m "更新描述"
   git push origin main     # 推送最新提交
   

---

五、其他常用命令

1. 查看状态

   git status  # 显示未跟踪/已修改的文件
   

2. 查看提交历史

   git log     # 按时间倒序显示提交记录
   

3. 拉取远程更新

   git pull origin main  # 将远程代码同步到本地
   

4. 分支管理

   git branch             # 查看分支
   git branch 分支名      # 创建新分支
   git checkout 分支名    # 切换分支
   git merge 分支名       # 合并分支到当前分支
   

---

六、本地项目提交同步完整示例

假设本地已有一个项目文件夹 my-project：

cd my-project
git init
git add .
git commit -m "首次提交项目结构"
git remote add origin https://github.com/yourname/my-project.git
git push -u origin main

---

七、注意事项

1. 忽略文件：创建 .gitignore 文件，列出需忽略的文件（如 node_modules/, .env）。
2. 冲突处理：git pull 时若提示冲突，需手动合并冲突文件后重新提交。
3. SSH 免密推送：推荐配置 SSH 密钥（参考各平台文档）。

---