【代码管理】git使用指南(新手向)

git init               # 初始化仓库
git clone URL          # 克隆远程仓库
git status             # 查看状态
git add .              # 添加修改
git commit -m "说明"   # 提交
git push               # 推送
git pull               # 拉取
git log                # 查看提交记录
git remote -v          # 查看远程仓库
git branch             # 查看分支
git checkout -b dev    # 创建并切换到 dev 分支
git merge dev          # 合并分支

一、安装与配置

1. 安装 Git

• Windows: 下载 Git for Windows

• Mac: brew install git

• Linux: sudo apt-get install git

检查是否安装成功：

git --version

2. 初始配置

配置用户名和邮箱（提交记录用来标识身份）：

git config --global user.name "你的GitHub用户名" 
git config --global user.email "你的GitHub注册邮箱"

查看配置：

git config --list

如果输错了，可以删除或修改：

git config --global --unset <usr.email> # 错误配置项 
git config --global --edit # 手动编辑配置文件-推荐

二、常用 Git 操作流程

1.初始化本地仓库

git init

2.连接远程仓库

it remote add origin https://github.com/你的用户名/你的仓库名.git 

如果地址写错了：

git remote set-url origin 新地址

查看远程仓库：

git remote -v

3.常用操作

git status # 查看状态 
git add . # 添加所有修改 
git commit -m "说明" # 提交到本地仓库 
git push # 推送到远程 
git pull # 拉取远程最新代码

第一次推送时需要绑定远程分支：

git push -u origin main

三、常见问题与解决方法

1. 远程仓库已存在

error: remote origin already exists. 

解决：

git remote set-url origin https://github.com/xxx/xxx.git

或

git remote remove origin git remote add origin https://github.com/xxx/xxx.git

---

2. 换行符提示

warning: LF will be replaced by CRLF

这是换行符不同导致的，不影响使用。
解决方案：

git config --global core.autocrlf false # 禁止自动转换

---

3. 没有上游分支

fatal: The current branch main has no upstream branch.

解决：

git push -u origin main

4. 网络错误（Connection reset / Couldn't connect to server）

• 原因：国内直连 GitHub 不稳定

• 解决方法：

  1. 检查仓库地址（必须是 .xxx.git 而不是 .xxx）

  2. 配置代理：

     git config --global http.proxy http://127.0.0.1:7890 
     git config --global https.proxy http://127.0.0.1:7890

  3. 改用 SSH（推荐，免密、稳定）：

     ssh-keygen -t rsa -C "你的邮箱" 
     git remote set-url origin [e-mail]:你的用户名/仓库名.git 
     ssh -T [e-mail]