Git 初次安装完整基础配置

0 阅读2分钟

一、安装 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 "项目专用邮箱"

四、初始化本地仓库(新项目从零开始)

  1. 进入项目文件夹
cd /你的项目文件夹
  1. 初始化 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 免密配置(可选,不用每次输账号密码)

  1. 生成密钥
ssh-keygen -t ed25519 -C "你的邮箱"

一路回车,不设置密码
2. 读取公钥
Windows:cat ~/.ssh/id_ed25519.pub
复制全部内容,粘贴到 Gitee/GitHub 个人设置的 SSH 公钥处。
之后克隆、推送都不用输入账号密码。