刚开始用 Git 的时候,很多人卡在第一步:怎么把本地项目和远程仓库连上。尤其是团队协作开发,远程仓库初始化项目这一步没搞明白,后面提交代码、拉取更新全都会出问题。
先创建远程仓库
比如你在 GitHub 或 Gitee 上新建一个项目,填好名字,选好公开或私有,然后点击“创建”。这时候远程仓库就准备好了,但它是空的,什么都没有。
初始化本地项目并关联远程
假设你本地刚写完一个简单的网页项目,目录里已经有 index.html 和 style.css。现在想把这个项目传到远程仓库。
第一步,在项目根目录打开终端,运行:
git init
这一步会在本地生成 .git 文件夹,项目就开始被 Git 跟踪了。
接着添加所有文件到暂存区:
git add .
提交第一次版本:
git commit -m "初始提交"
连接远程仓库
回到 GitHub 页面,复制仓库的 HTTPS 或 SSH 地址。然后在终端执行:
git remote add origin https://github.com/yourname/your-project.git
这里的 origin 是远程仓库的默认别名,以后推拉代码都靠它。
推送代码到远程
第一次推送时,通常主分支叫 main 或 master。你可以查看当前分支:
git branch
如果分支是 main,运行:
git push -u origin main
加上 -u 参数后,下次直接用 git push 就行,不用再指定分支和远程名。
常见问题处理
有时候推送失败,提示“远程仓库非空”。这种情况多见于创建仓库时勾选了“添加 README”或“.gitignore”。解决办法是先拉取远程内容:
git pull origin main --allow-unrelated-histories
合并后再推送。不过建议初始化项目时,远程仓库保持空白,本地初始化后再推上去,避免冲突。
小技巧:一键初始化脚本
如果你经常建新项目,可以写个简单脚本自动完成初始化流程。比如新建一个 init-git.sh 文件:
git init
git add .
git commit -m "初始提交"
git remote add origin $1
git push -u origin main
使用时执行 sh init-git.sh https://github.com/xxx/xxx.git,省时省力。
远程仓库初始化项目其实不复杂,关键步骤就那几步:本地 init、commit、remote add、push。搞清楚顺序,以后每次开新项目都能快速上线。