Git 2.33 基础命令实战从零到首次 Push 的 10 个核心步骤当你第一次在 Mac 上打开终端准备将代码推送到远程仓库时可能会感到有些不知所措。Git 作为现代开发者的必备工具其强大之处在于它能精确记录每一次代码变更。本文将带你完成从初始化本地仓库到首次推送代码的完整闭环每个步骤都配有实际场景中的注意事项。1. 环境准备与 Git 安装验证在开始之前确保你的 macOS 已经安装了 Git 2.33 或更高版本。打开终端Terminal.app输入以下命令检查当前版本git --version如果系统提示未安装可以通过以下两种方式之一获取最新版Homebrew 安装方式推荐brew install git官方二进制安装包步骤访问 Git 官方网站下载最新版.dmg安装包双击运行安装向导提示使用 Homebrew 安装的优势在于后续升级更方便只需执行brew upgrade git安装完成后需要配置基础用户信息这些信息会出现在你的提交记录中git config --global user.name 你的姓名 git config --global user.email 你的邮箱可以通过以下命令验证配置是否生效git config --list2. 创建并初始化本地仓库选择一个合适的目录作为项目根目录这里我们以~/projects/my-app为例mkdir -p ~/projects/my-app cd ~/projects/my-app初始化 Git 仓库会创建隐藏的.git目录这是 Git 的核心数据库git init成功初始化后终端会显示Initialized empty Git repository in /Users/you/projects/my-app/.git/此时可以查看仓库状态git status新建项目通常会包含一些不需要版本控制的文件如 IDE 配置、编译产物等创建.gitignore文件来排除它们touch .gitignore典型的.gitignore内容示例# 排除系统文件 .DS_Store # 排除Node.js依赖 node_modules/ # 排除IDE配置 .idea/ *.iml # 排除日志文件 *.log3. 添加文件到暂存区创建一个示例文件并查看状态变化echo # My Project README.md git status你会看到README.md被标记为 Untracked files。使用add命令将其加入暂存区git add README.md如果要添加所有新文件和修改过的文件不包括.gitignore排除的git add .注意git add .会添加当前目录所有变更建议先通过git status确认变更内容4. 提交变更到本地仓库将暂存区的内容创建为一个永久快照git commit -m Initial commit with README良好的提交消息应遵循以下规范首行不超过50字符的摘要空一行后补充详细说明可选使用现在时态祈使句如 Fix bug 而非 Fixed bug查看提交历史git log --oneline5. 连接远程仓库假设你已经在 GitHub 创建了空仓库获取其 SSH 地址格式如gitgithub.com:username/repo.git然后添加为远程源git remote add origin gitgithub.com:username/repo.git验证远程连接git remote -v如果使用 HTTPS 协议遇到认证问题可配置 Git 的凭证存储git config --global credential.helper osxkeychain6. 分支管理基础查看当前分支状态git branch创建一个新功能分支git checkout -b feature/login在分支间切换git checkout main7. 解决首次推送的常见问题直接推送可能会遇到上游分支未设置的错误fatal: The current branch main has no upstream branch.正确的首次推送命令需要设置上游关联git push -u origin main-u参数建立跟踪关系后续推送只需git push8. 处理远程变更当其他人已向远程仓库推送代码时你需要先拉取最新变更git pull origin main如果存在冲突Git 会标记冲突文件解决后需要git add . git commit -m Resolve merge conflicts git push9. 查看与对比变更查看工作区与暂存区的差异git diff查看暂存区与最新提交的差异git diff --cached查看特定文件的修改历史git log -p README.md10. 进阶配置与优化设置命令别名简化常用操作git config --global alias.co checkout git config --global alias.br branch git config --global alias.ci commit git config --global alias.st status启用彩色输出提升可读性git config --global color.ui true配置默认文本编辑器如VS Codegit config --global core.editor code --wait常见工作流总结表格场景命令序列说明日常提交git add .→git commit -m msg→git push基础三连分支开发git checkout -b feat→ 开发 →git push -u origin feat功能隔离合并分支git checkout main→git merge feat→git push合并到主分支撤销修改git checkout -- file.txt放弃工作区修改重置提交git reset --soft HEAD~1撤销上次提交但保留更改遇到问题时记住这三个救命命令git reflog # 查看所有操作历史 git reset --hard commit_id # 回退到指定状态 git clean -fd # 清除未跟踪文件在真实项目中建议定期执行git fetch --all获取所有远程更新再通过git log --all --graph可视化分支拓扑关系。养成小步提交的习惯每个提交只解决一个问题这样在需要回退时会更加灵活。