GitHub 新手上传代码到远程仓库教程——Windows10系统

一、准备工作

1.安装 Git

Windows: 从 Git 官网下载安装包，按默认选项安装。https://git-scm.com/downloads
Mac: 使用 Homebrew 安装 brew install git，或从官网下载安装包
Linux: 使用包管理器安装，如 Ubuntu: sudo apt-get install git

2.注册 GitHub 账号

• 访问 GitHub 官网注册账号。https://github.com
• 登录后，点击右上角 “+” 图标，选择 “New repository” 创建新仓库
• 填写仓库名称，添加描述（可选），选择 “Public” 或 “Private”，勾选 “Initialize this repository with a README”，点击 “Create repository”
  

二、配置 Git

打开终端（Windows 为 Git Bash），配置用户名和邮箱：

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

三、上传代码步骤

方法 1: 克隆远程仓库后添加文件（推荐新手）

• 克隆仓库到本地

git clone https://github.com/你的用户名/你的仓库名.git

就是一里2操作的仓库名，本地目录下会生成文件夹，把git里文件都会下载（克隆）。

• 进入仓库目录

ls 查看目录下文件
cd 你的仓库名

• 将你的代码文件/新建的文件夹复制或移动到这个目录下
• 查看文件状态

git status

红色文件表示未跟踪的文件，我复制了两个文件夹过来，还修改了README。

• 添加文件到暂存区

# 添加单个文件
git add 文件名 

# 添加所有文件
git add .

• 提交文件到本地仓库

git commit -m "这里填写提交说明，如：首次提交代码"

文件夹里单个文件很多

• 推送到远程仓库

git push origin main

（如果提示输入账号密码，输入你的 GitHub 账号密码；如果使用两步验证，需要生成并使用个人访问令牌）
点击Sign in with your browser跳转网页，然后关闭，就上传到了远程仓库。


浏览器刷新远程仓库就显示上传成功了。

方法 2: 本地已有项目，关联远程仓库

简单理解为你已经做完的工程，所有文件夹，不需要移动，复制，直接把本地变成本地，初始化直接上传。代码有重复，就不截图了。

• 步骤 1: 在 GitHub 上创建新仓库
  • 登录你的 GitHub 账号，点击右上角 “+” 图标，选择 “New repository”，填写仓库名称（建议与本地项目名一致），可选：添加描述、选择公有 / 私有，重要：不要勾选 “Initialize this repository with a README”（因为本地已有项目，点击 “Create repository”。
• 步骤 2: 进入本地项目目录
  • 打开终端（Windows 用 Git Bash），进入你的本地项目文件夹：

cd /path/to/your/local/project

• 步骤 3: 初始化本地 Git 仓库
  • 如果你的项目还没有被 Git 管理，需要初始化：

git init

执行后会在项目目录下创建一个隐藏的.git文件夹

• 步骤 4: 添加文件到暂存区

# 添加所有文件
git add .

# 或者添加指定文件
git add 文件名1 文件名2

• 步骤 5: 提交到本地仓库

git commit -m "首次提交本地项目"

（引号中的内容是提交说明，建议写清楚本次提交的内容）

• 步骤 6: 关联远程仓库
  • 复制你在 GitHub 上创建的仓库地址（HTTPS 或 SSH 格式），执行：

git remote add origin https://github.com/你的用户名/你的仓库名.git

验证是否关联成功：git remote -v，会显示远程仓库地址

• 步骤 7: 推送到远程仓库

# 第一次推送需要指定分支并关联
git push -u origin main

（如果你的默认分支是master，则用git push -u origin master）