在 MacBook Air 上开发项目，Git 是版本管理的必备工具。很多新手第一次接触时会被终端命令劝退，其实只要掌握几个核心步骤，就能轻松上手。下面这篇教程会带你从零开始，完成环境配置到日常提交的全部流程。
第一步：检查并安装 Git 环境
打开 Finder，进入应用程序文件夹，找到终端 App 并双击运行。在弹出的黑框里输入 git version 然后按回车。如果屏幕显示类似 git version 2.39.0 的字样，说明系统已经自带了 Git，可以直接跳过安装步骤。如果没有显示或提示未找到命令，就需要手动安装了。最简单的方法是在终端输入 xcode-select --install 然后回车，系统会自动弹出命令行工具安装窗口，点击安装并等待进度条走完即可。这一步不仅装好了 Git，还补齐了 macOS 开发需要的底层依赖。
第二步：初始化用户身份信息
Git 每次提交代码时都需要记录作者是谁，所以必须提前设置好用户名和邮箱。继续在终端输入以下两行命令，把括号里的内容替换成你自己的信息。第一行设置本地仓库的用户名，第二行设置绑定邮箱。注意邮箱不需要真的能收到邮件，但格式要符合规范。全部输完后可以输入 git config --list 查看是否生效。这些配置只会保存在当前电脑上，不会同步到云端，所以不用担心隐私泄露。
第三步：创建仓库并提交代码
假设你已经有一个写好的项目文件夹，把它拖到终端窗口里，或者用 cd 命令切换路径。输入 git init 初始化一个空仓库，你会看到隐藏的 .git 文件夹被创建出来。接下来把文件加入暂存区，输入 git add . 表示添加当前目录下所有文件，也可以单独指定文件名。确认无误后执行 git commit -m 描述你的修改内容 把文件保存到历史记录里。引号内的描述尽量简短明确，比如修复登录页报错或者新增首页布局。这时候代码已经安全地留在了本地数据库。
第四步：关联远程仓库并推送
本地保存再多也不如放在 GitHub 或 Gitee 上保险。先在网页端新建一个空白仓库，拿到项目的 HTTPS 地址。回到终端输入 git remote add origin 粘贴的地址 建立本地与云端的连接。如果之前关联过其他地址，可以用 git remote set-url origin 新地址 覆盖掉。准备工作完成后，输入 git push -u origin master 将代码推送到云端。macOS 的终端可能会要求你输入账号和密码，如果是 GitHub 用户，这里需要填写个人访问令牌而不是登录密码，去设置页面生成一个带读写权限的令牌填进去就行。推送成功后，刷新网页就能看到完整的项目结构。
第五步：日常协作与常用命令速查
团队协作时，每天开工前先跑一下 git pull 拉取队友的最新改动，避免文件冲突。写完新功能记得走一遍 add、commit、push 的标准流程。如果需要回滚到昨天的状态，可以用 git log 查看历史提交记录，复制对应的长哈希值，输入 git reset --hard 哈希值 就能瞬间穿越回去。遇到合并冲突不要慌，终端会明确标出冲突位置，手动编辑文件删除多余的符号后再重新提交即可。MacBook Air 的芯片性能很强，编译和提交速度都很快，合理搭配快捷键和别名配置能让操作更流畅。
常见问题排查技巧
如果推送时一直提示权限拒绝，多半是密钥过期或者分支名称不对。现在主流仓库默认主分支叫 main 而不是 master，推送时可以加上 git branch -M main 统一命名。遇到终端乱码或字体太小，可以在终端偏好设置里更换配色方案和字号。大部分网络问题可以通过关闭代理服务器或切换 DNS 解决。保持终端干净的方法是定期清理缓存，输入 git gc --prune=now 能释放不必要的磁盘空间。掌握这些基础操作后，你就能在 MacBook Air 上丝滑地进行全栈开发了。
