核心三步是:准备远程地址、确保 ssh 或 https 可用、执行 git remote add 命令并验证;需先创建 github 空仓库获取正确 url,推荐 ssh(需预配密钥),https 更便捷;添加后用 git remote -v 检查,再用 git push -u origin main 推送首次提交。

用 git remote add 把本地仓库连上 GitHub 远程仓库,核心就三步:准备远程地址、确保 SSH 或 HTTPS 可用、执行命令并验证。关键不是“能不能加”,而是“加得对不对、后续推得顺不顺”。
确认远程仓库已创建,并拿到正确 URL
先登录 GitHub,新建一个空仓库(比如叫 my-project),不要勾选 “Initialize this repository with a README”。创建完成后,页面会显示类似这样的地址:
推荐用 SSH(更安全、免输密码),但前提是已配置好 SSH Key 并添加到 GitHub 账户;如果没配过,先用 HTTPS 地址更省事。
在本地仓库中运行 git remote add
确保你已在本地项目的根目录下(即有 .git 文件夹的地方),然后运行:
- 用 HTTPS:
git remote add origin https://github.com/yourname/my-project.git - 用 SSH:
git remote add origin git@github.com:yourname/my-project.git
其中 origin 是远程仓库的别名(常用默认名),你也可以换成 upstream 或 github 等,但后续操作要保持一致。
Conventional Commits v1.0.0 分支、工作树命名及提交信息规范,适用于 GitHub 与 GitLab 项目,用于创建分支和命名工作树等场景。
检查是否添加成功,并推送首次提交
运行以下命令查看远程配置:
git remote -v
如果看到两行输出,都指向你刚填的地址(一行 fetch,一行 push),说明关联成功。
接着把本地内容推上去:
- 如果本地已有提交:
git push -u origin main(或master,取决于默认分支名) - 如果还没提交,先做:
git add . && git commit -m "initial commit" && git push -u origin main
遇到 “remote origin already exists” 怎么办
说明本地已经存在名为 origin 的远程地址。不用删仓库,直接换名或更新即可:
- 换个别名添加:
git remote add github https://github.com/yourname/my-project.git - 或者改现有地址:
git remote set-url origin https://github.com/yourname/my-project.git - 想彻底替换(谨慎):
git remote remove origin && git remote add origin 新地址










