Git配置入门：从零开始搭建你的版本控制系统

Git配置入门从零开始搭建你的版本控制系统 前言Git 是目前最流行的分布式版本控制系统广泛应用于软件开发中。无论你是前端、后端、数据科学还是运维工程师掌握 Git 都是必不可少的技能。本教程将带你从零开始配置 Git 环境并完成第一次代码提交帮助你快速上手使用 Git 进行版本管理。✅ 第一步安装 Git1. 下载与安装根据你的操作系统选择对应的安装方式 Windows访问官网https://git-scm.com下载Git for Windows也叫 Git Bash安装时建议勾选添加到PATH环境变量使用 Vim 作为默认编辑器可选配置行尾换行符转换推荐使用默认设置安装完成后可通过菜单或搜索打开Git Bash macOS使用 Homebrew 安装推荐brewinstallgit或从官网下载安装包安装。 Linux (Ubuntu/Debian)sudoaptupdatesudoaptinstallgit其他发行版请使用对应包管理器如yum,dnf,pacman2. 验证安装是否成功打开终端Terminal或 Git Bash运行以下命令git--version输出示例git version 2.39.2如果显示版本号说明安装成功 ✅✅ 第二步配置用户信息Git 需要知道你是谁才能记录每次提交的作者信息。设置用户名和邮箱全局配置gitconfig--globaluser.name你的名字gitconfig--globaluser.emailyour-emailexample.com 示例gitconfig--globaluser.name张三gitconfig--globaluser.emailzhangsanexample.com⚠️ 注意邮箱建议使用注册 GitHub/Gitee 等平台的邮箱便于关联提交记录。查看当前配置gitconfig--list你会看到类似内容user.name张三 user.emailzhangsanexample.com ...✅ 第三步配置文本编辑器可选Git 在需要输入提交信息时会调用默认编辑器。你可以指定你喜欢的编辑器。设置为 VS Code推荐gitconfig--globalcore.editorcode --wait设置为 Vim默认gitconfig--globalcore.editorvim设置为 NotepadWindowsgitconfig--globalcore.editorC:/Program Files/Notepad/notepad.exe -multiInst -nosession✅ 第四步配置默认分支名称推荐默认情况下Git 初始化仓库时会创建master分支。但现在很多项目已改为main。建议统一使用maingitconfig--globalinit.defaultBranch main✅ 第五步生成 SSH 密钥用于免密推送代码使用 HTTPS 每次推送都需要输入账号密码而 SSH 可以实现免密登录。1. 检查是否已有 SSH 密钥ls~/.ssh/id_rsa.pub若无输出则需要生成新密钥。2. 生成新的 SSH 密钥ssh-keygen-ted25519-Cyour-emailexample.com 提示连续按回车使用默认路径即可。3. 启动 SSH 代理并添加密钥eval$(ssh-agent-s)ssh-add ~/.ssh/id_ed255194. 复制公钥内容# Linux/macOScat~/.ssh/id_ed25519.pub# Windows (Git Bash)typeC:\Users\你的用户名\.ssh\id_ed25519.pub复制输出内容以ssh-ed25519开头包含你的邮箱。5. 添加公钥到代码托管平台GitHub: Settings → SSH and GPG keys → New SSH keyGitee: 设置 → 安全设置 → SSH 公钥GitLab: Preferences → SSH Keys粘贴公钥保存即可。6. 测试连接# GitHubssh-Tgitgithub.com# Giteessh-Tgitgitee.com成功提示示例Hi 张三! Youve successfully authenticated, but GitHub does not provide shell access.✅ 表示 SSH 配置成功✅ 第六步创建第一个本地仓库1. 创建项目文件夹mkdirmy-first-projectcdmy-first-project2. 初始化 Git 仓库gitinit此时该目录下会生成一个隐藏的.git文件夹用于存储版本信息。3. 创建测试文件echo# 我的第一个 Git 项目README.md4. 查看状态gitstatus你会看到README.md处于“未跟踪”状态。✅ 第七步提交代码到本地仓库1. 将文件加入暂存区gitaddREADME.md或添加所有更改gitadd.2. 提交到本地仓库gitcommit-mfeat: 初始化项目添加 README✅-m后面是提交信息务必清晰描述修改内容。✅ 第八步关联远程仓库以 GitHub 为例1. 在 GitHub 上新建仓库登录 https://github.com点击 “New repository”填写仓库名如my-first-project选择公开Public❌ 不要勾选 “Initialize this repository with a README”2. 关联远程仓库gitremoteaddorigin gitgithub.com:你的用户名/my-first-project.git 替换为你自己的 GitHub 用户名和仓库地址3. 推送代码到远程gitpush-uorigin main首次推送使用-u参数会设置上游分支以后只需git push即可。 恭喜你已完成 Git 初始配置你现在拥有了一个完整的 Git 工作环境可以开始进行日常的版本控制操作了 常用命令速查表命令功能git init初始化新仓库git clone url克隆远程仓库git status查看当前状态git add .添加所有变更到暂存区git commit -m message提交更改git push推送到远程仓库git pull拉取最新代码git log查看提交历史git config --list查看配置信息 学习资源推荐 官方文档https://git-scm.com/book/zh/v2 B站视频搜索 “Git 零基础入门” 实践平台GitHub / Gitee / GitLab❓ 常见问题解答Q1提交时出现Please tell me who you are.错误 忘记配置user.name和user.email请运行gitconfig--globaluser.name你的名字gitconfig--globaluser.email你的邮箱Q2推送被拒绝怎么办确保已正确配置 SSH远程仓库地址正确分支名称一致main vs master可用以下命令强制同步慎用gitpush-uorigin main--force✅ 总结通过本教程你已经完成了✅ 安装 Git✅ 配置用户信息✅ 设置默认分支为main✅ 生成并配置 SSH 密钥✅ 创建本地仓库并提交代码✅ 推送至远程仓库现在你可以自信地说“我会用 Git 了” 继续练习commit、push、pull等操作逐步掌握