咨询如何创建新repository并上传至GitHub的操作方法

网页端创建远程空仓库 #

• 登录GitHub账号后，点击页面右上角的+图标，下拉菜单选择New repository
• 按页面提示填写仓库信息：
  • Repository name：必填，填写仓库名称，建议和本地项目名保持一致
  • Description：选填，填写项目功能简介
  • 可见性选择：Public为公开仓库，所有访问者均可查看；Private为私有仓库，仅你授权的账号可访问
  • 本地已有完整项目的情况下，不要勾选初始化选项区的Add a README file、Add .gitignore、Choose a license，避免后续推送出现版本冲突
• 信息填写完成后点击底部的Create repository按钮，即可完成远程仓库创建，跳转后的页面会显示仓库的远程地址，先保留页面不要关闭

本地项目上传到远程仓库 #

操作前请确保本地已安装Git，且完成全局身份配置，未配置的话先在终端执行以下两条命令：

git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub绑定邮箱"

后续操作按顺序执行：

• 打开终端（Windows系统建议用Git Bash，Mac/Linux直接用系统终端），通过cd 你的本地项目根目录路径命令进入项目文件夹
• 初始化本地Git仓库：执行git init，执行成功后项目根目录会生成隐藏的.git文件夹
• （可选）如果有不需要上传的文件（比如依赖包、本地配置文件、日志文件等），先在项目根目录新建.gitignore文件，把需要排除的文件/文件夹名称逐行写入，Git会自动忽略这些内容
• 将项目所有文件添加到暂存区：执行git add .（注意add后有个英文句号，代表添加当前目录下所有未被忽略的文件）
• 将暂存区内容提交到本地仓库：执行git commit -m "first commit"，双引号内为本次提交的说明文字，首次提交写first commit即可，后续提交建议写清楚本次修改的内容
• 关联之前创建的远程仓库：执行git remote add origin 你的远程仓库地址，地址从刚才创建完仓库的引导页复制即可，支持HTTPS和SSH两种格式，推荐配置SSH密钥后用SSH地址，后续推送不需要反复输入账号密码
• （可选）如果你的本地Git默认分支名为master，可以执行git branch -M main将分支重命名为main，和GitHub当前默认分支名保持一致
• 推送本地提交内容到远程仓库：执行git push -u origin main，执行完成后刷新GitHub的仓库页面，就能看到你上传的所有项目文件了

常见报错处理：如果推送时提示远程仓库存在本地没有的文件（一般是创建仓库时勾选了初始化README导致的），先执行git pull --rebase origin main拉取远程内容合并到本地，再重新执行push命令即可。

内容的提问来源于stack exchange，提问作者José Bermudez Coa