刚接触开发的Mac用户经常会遇到版本控制的难题。作为代码管理的基石,Git的配置是每个开发者必须掌握的技能。我刚开始用Git时也踩过不少坑,比如SSH连接失败、密钥管理混乱等问题。下面我会用最直白的方式,带你一步步完成Git环境的搭建。
首先打开终端,输入git --version检查是否已安装Git。如果系统提示"command not found",说明需要手动安装。推荐从Git官网下载最新的macOS版本,国内用户也可以选择镜像源加速下载。安装过程非常简单,一直点击"继续"即可完成。
安装完成后,我们需要进行基础配置。这两个命令你一定要记住:
bash复制git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"
这里的邮箱建议使用你在代码托管平台(如Gitee或GitHub)注册的邮箱。配置完成后,可以用git config --global -l查看所有全局配置项。
SSH密钥是连接远程仓库的安全通道。我在团队协作时发现,90%的连接问题都出在密钥配置不当。让我们从生成密钥开始:
bash复制ssh-keygen -t rsa -C "你的邮箱"
执行后会提示保存路径,直接回车使用默认的~/.ssh目录即可。接着会让你设置密码(可选),我建议初学者可以先不设密码。最终会生成两个文件:id_rsa(私钥)和id_rsa.pub(公钥)。
查看公钥内容的命令是:
bash复制cat ~/.ssh/id_rsa.pub
把输出的内容完整复制,接下来需要添加到代码托管平台。以Gitee为例:
测试连接是否成功:
bash复制ssh -T git@gitee.com
第一次连接会询问是否信任主机,输入yes后如果看到欢迎信息就说明成功了。
在实际使用中,我遇到过多次SSH连接失败的情况。最常见的问题是密钥未被正确加载。Mac有个特殊机制叫钥匙串(Keychain),我们需要确保密钥被正确添加:
bash复制ssh-add ~/.ssh/id_rsa
ssh-add -K ~/.ssh/id_rsa
第一条命令加载私钥,第二条将其存入钥匙串。为了永久生效,我们还需要创建SSH配置文件:
bash复制cd ~/.ssh
touch config
open config
在打开的文件中添加:
code复制Host *
UseKeychain yes
AddKeysToAgent yes
IdentityFile ~/.ssh/id_rsa
这个配置会让系统自动管理密钥,避免每次都需要输入密码。
对于刚接触Git命令的新手,SourceTree这样的图形化工具能大幅降低学习门槛。安装过程很简单:
创建第一个仓库的步骤:
连接远程仓库时要注意:
很多开发者同时使用Gitee和GitHub,我推荐为每个平台创建独立的密钥对。方法是在生成密钥时指定不同文件名:
bash复制ssh-keygen -t rsa -C "gitee邮箱" -f ~/.ssh/gitee_id_rsa
ssh-keygen -t rsa -C "github邮箱" -f ~/.ssh/github_id_rsa
然后在config文件中分别配置:
code复制Host gitee.com
HostName gitee.com
IdentityFile ~/.ssh/gitee_id_rsa
Host github.com
HostName github.com
IdentityFile ~/.ssh/github_id_rsa
这样系统会根据域名自动选择对应的密钥。
一个标准的Git工作流程是这样的:
bash复制git pull origin main
bash复制git checkout -b feature/新功能
bash复制git add .
git commit -m "描述变更内容"
bash复制git push origin feature/新功能
在SourceTree中这些操作都可以通过点击按钮完成,建议新手先用图形界面熟悉流程,再逐步学习命令行。
经过几个项目的实战,我总结了这些提升效率的技巧:
特别提醒:SourceTree首次加载大型仓库时可能会卡顿,这是正常现象。建议先喝杯咖啡,等索引完成后再操作会更流畅。