一、安装 Git
Windows:官网下载安装包一路下一步;Mac:brew install git;Linux:apt install git / yum install git
安装完成验证:打开终端/CMD/PowerShell
git --version
# 输出版本号即成功
二、全局核心配置(必须先配,所有仓库共用)
1. 设置用户名、邮箱(提交代码标识,和 Gitee/GitHub 账号保持一致)
# 替换成你自己的名字、注册邮箱
git config --global user.name "张三"
git config --global user.email "zhangsan@xxx.com"
2. 查看全局配置
# 全部配置列表
git config --global --list
# 单独查看用户名
git config --global user.name
3. 基础辅助配置(推荐全部设置)
# 1. 设置默认拉取合并策略
git config --global pull.rebase true
# 2. 设置默认分支名为 main(新版规范,替代旧的 master)
git config --global init.defaultBranch main
# 3. 开启彩色输出,命令行更好看
git config --global color.ui auto
# 4. 设置编辑器(Windows 可选 notepad++,Mac 可选 vscode)
# 使用 VSCode 作为默认编辑工具
git config --global core.editor "code --wait"
# 5. 解决 Windows 换行符兼容问题(必配)
git config --global core.autocrlf true
# Mac/Linux 使用 input
# git config --global core.autocrlf input
三、仓库局部配置(仅当前项目生效,不加 --global)
进入项目文件夹执行,优先级高于全局:
git config user.name "项目专用名"
git config user.email "项目专用邮箱"
四、初始化本地仓库(新项目从零开始)
- 进入项目文件夹
cd /你的项目文件夹
- 初始化 git 仓库,生成隐藏
.git文件夹
git init
五、基础首次操作流程
# 1. 添加所有文件到暂存区
git add .
# 2. 提交到本地仓库,引号内写本次修改说明
git commit -m "第一次提交:初始化项目文件"
六、绑定远程仓库(GitHub/Gitee/GitLab)
1. 添加远程地址
# origin 是远程仓库默认别名
git remote add origin https://gitee.com/xxx/xxx.git
2. 查看远程仓库
git remote -v
3. 推送本地代码到远程
git push -u origin main
# -u 只第一次推送加,绑定本地main与远程main分支
# 后续推送直接 git push
七、配置文件位置
- 全局配置:
Windows:C:\Users\用户名.gitconfig
Mac/Linux:~/.gitconfig - 项目局部配置:项目内
.git/config
八、常用小命令
# 删除全局配置
git config --global --unset user.name
# 拉取远程最新代码
git pull
补充:SSH 免密配置(可选,不用每次输账号密码)
- 生成密钥
ssh-keygen -t ed25519 -C "你的邮箱"
一路回车,不设置密码
2. 读取公钥
Windows:cat ~/.ssh/id_ed25519.pub
复制全部内容,粘贴到 Gitee/GitHub 个人设置的 SSH 公钥处。
之后克隆、推送都不用输入账号密码。