1.安装git
在Windows下直接安装git Windows即可
在Linux/WSL:sudo apt install git
2.设置用户名和邮箱(用于提交记录)
git config --global user.name "你的名字"
git config --global user.email "you@example.com"
查看配置:git config --list
3.初始化仓库
在你的项目根目录:
cd /path/to/your/project
git init
这会生成一个 .git 文件夹,Git 会在这里记录版本信息。
(如果是新建项目,在创建GitHub仓库时,会有详细的流程,教你如何上传相应的代码)
(如果接着别人的项目开发又是不一样,下面详细展开说明)
4.常用工作流
查看当前状态
git status
添加到暂存区
git add 文件名 # 添加指定文件
git add . # 添加当前目录所有改动
提交版本
git commit -m "描述这次修改的内容"
查看提交记录
git log --oneline --graph --decorate
5.远程仓库(GitHub / Gitee / GitLab)
关联远程仓库
git remote add origin git@github.com:用户名/仓库名.git
首次推送
git push -u origin main # 如果默认分支是 main
拉取远程更新
git pull
生成 SSH key(推荐)
运行 ssh-keygen -t ed25519 -C "you@example.com",然后将 ~/.ssh/id_ed25519.pub 的内容添加到 GitHub/Gitee 的 SSH key 设置中,实现免密操作。
分支管理
创建分支:git branch dev
切换分支:git checkout dev 或 git switch dev
合并分支:git merge dev
删除分支:git branch -d dev
忽略文件
在项目根目录创建 .gitignore 文件,例如:
*.pyc
__pycache__/
data/
这样这些文件不会被 Git 跟踪。
实用技巧
查看差异:git diff
撤销改动:
撤销未暂存:git checkout -- 文件名
撤销已暂存:git reset 文件名
回退版本:
保留修改:git reset --soft HEAD~1
丢弃修改:git reset --hard HEAD~1
clone别人的仓库作为基准
本地目录已经是一个完整的 Git 仓库(包含 .git 目录),不需要再 git init。
任务场景一:给原仓库贡献(Pull Request)
克隆项目
git clone git@github.com:原作者/项目名.git
cd 项目名
远程 origin 默认指向原作者的仓库。
创建分支开发
git checkout -b my-feature
修改代码 → 提交
git add .
git commit -m "feat: 添加某功能"
推送到自己 Fork 的仓库
你需要先在 GitHub 上 Fork 这个项目,然后修改远程:
git remote set-url origin git@github.com:你的用户名/项目名.git
git push -u origin my-feature
在 GitHub 上发起 Pull Request,让原作者审核合并。
任务场景二:当作模板,建自己的仓库
如果你只是想用别人的代码当起点,不打算提交回去,可以这样:
克隆后解除和原仓库的绑定
git clone https://github.com/原作者/项目名.git
cd 项目名
git remote remove origin
在 GitHub/Gitee 创建你自己的空仓库,得到地址,例如:
git@github.com:你的用户名/新仓库.git
绑定到新的远程仓库
git remote add origin git@github.com:你的用户名/新仓库.git
git push -u origin main # 或 master
之后 git push 就是推送到你自己的仓库了。