Git上传本地文件到GitHub教学指南

一、先理解几个概念

Git是本地版本管理工具，负责记录你本地文件的修改历史。

GitHub是远程嗲吗托管平台，可以把你的Git项目上传到网上，方便备份、展示和协作。

简单理解：

plain 复制代码

你的电脑本地文件 -> Git管理 -> 上传到GitHub仓库

Git官方文档说明，git init会在当前目录创建一个空的Git仓库，也就是生成 .git目录来记录版本信息。GitHubGit - git-init Documentation官方文档也说明， git push 用于把本地提交推送到远程仓库，常见形式是git push origin main GitHub Docs。

二、准备工作

安装Git

Windows用户直接安装Git for Windows。安装完成后，右键文件夹空白处一般会出现：

plain 复制代码

Git Bash Here

Mac 用户可以在终端输入：

bash 复制代码

git --version

如果没有安装，系统一般会提示安装开发者工具。

Linux用户可以用：

bash 复制代码

sudo apt install git

安装完成后，检查Git是否可用：

bash 复制代码

git --version

如果出现类似下面的信息，说明安装成功：

bash 复制代码

git version 2.xx.x

三、配置Git用户信息

第一次使用Git，需要告诉Git你是谁。这个用户名和邮箱会显示在提交记录里。GitHub官方文档说明，可以通过git config 设置提交用户名和提交邮箱。GitHub Docs

打开Git Bash或终端，输入：

bash 复制代码

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

例如：

bash 复制代码

git config --global user.name "m72102043"
git config --global user.email "m72102043@gmail.com"

检查是否配置成功：

bash 复制代码

git config --global user.name
git config --global user.email

此时会分别显示出你的用户名和邮箱。

四、在GitHub上创建一个传承仓库

进入GitHub后：

点击右上角的+
选择New repository
输入仓库名，例如：

plain 复制代码

my-first-project

选择仓库类型：

plain 复制代码

Public：公开仓库，别人可以看到
Private：私有仓库，只有你自己或授权的人可以看到

初学者建议：不要勾选README、.gitignore、License

原因是：如果GitHub远程仓库里已经有README，而你的本地仓库是另一个独立历史，第一push时容易出现冲突。

创建完成后，你会得到一个仓库地址，通常有两种：

HTTPS形式：

plain 复制代码

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

SSH形式：

plain 复制代码

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

初学者可以先用HTTPS。需要注意，现在GitHub不再接受账号密码直接用于Git操作认证，推送时需要用token、SSH key或浏览器授权等认证方式。Git password authentication is shutting down - GitHub Changelog

五、把本地文件上传到GitHub：标准流程

假设你的本地项目文件夹是：

plain 复制代码

D:\project\my-first-project

第一步：进入你的项目文件夹

在项目文件夹空白处右键，选择：

plain 复制代码

Git Bash Here

或者在终端中进入文件夹：

bash 复制代码

cd /d/project/my-first-project

Windows路径也可以是这样：

bash 复制代码

cd D:/project/my-first-project

第二步：初始化 Git 仓库

bash 复制代码

git init

执行后，这个文件夹就被 Git 管理了。

第三步：查看文件状态

bash 复制代码

git status

你会看到哪些文件还没被 Git 跟踪。

第四步：添加文件到暂存区

添加当前文件夹下的所有文件：

bash 复制代码

git add .

意思是：把当前目录下所有新增、修改的文件加入 Git 的暂存区。

如果只想添加某一个文件，例如main.py：

bash 复制代码

git add main.py

第五步：提交文件

bash 复制代码

git commit -m "first commit"

这里的"first commit"是提交说明，可以自己改，比如：

bash 复制代码

git commit -m "upload initial project files"

commit 可以理解为：给当前文件状态拍一个快照。

第六步：设置主分支名为 main

bash 复制代码

git branch -M main

现在GitHub默认分支通常使用main，所以这里统一改成 main。

第七步：连接GitHub远程仓库

把下面的地址换成你自己的GitHub仓库地址：

bash 复制代码

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

例如：

bash 复制代码

git remote add origin https://github.com/m72102043/my-first-project.git

Git官方文档说明，git remote add 可以添加一个远程仓库地址，并用一个短名称来引用艾特，通常这个短名称叫origin。GitHub官方文档也说明，git remote add origin <REMOTE_URL>会把 origin 这个名字和远程仓库地址关联起来。

检查远程仓库是否添加成功：

bash 复制代码

git remote -v

如果看到类似：

bash 复制代码

origin  https://github.com/m72102043/my-first-project.git (fetch)
origin  https://github.com/m72102043/my-first-project.git (push)

说明连接成功。

第八步：上传到GitHub

bash 复制代码

git push -u origin main

第一次推送建议加 -u ，意思是把本地 main 分支和远程 main 分支关联起来。以后在上传时，可以直接使用：

bash 复制代码

git push

GitHub官方文档说明，git push通常需要指定远程名和分支名，例如git push origin main。

六、完整命令汇总

你可以直接把下面这套流程记住：

bash 复制代码

git init
git add .
git commit -m "first commit"
git branch -M main
git remote add origin https://github.com/你的用户名/仓库名.git
git push -u origin main

例如：

bash 复制代码

git init
git add .
git commit -m "first commit"
git branch -M main
git remote add origin https://github.com/m72102043/my-first-project.git
git push -u origin main

七、以后修改文件后怎么再次上传？

以后你修改了代码或文件，不需要重新git init，只需要三步：

bash 复制代码

git add .
git commit -m "update project"
git push

这是最常用的Git日常流程：

bash 复制代码

修改文件 -> git add -> git commit -> git push

八、如何确认上传成功

上传成功后，打开GitHub仓库页面，刷新页面。

如果你看到本地文件已经出现在GitHub仓库里，就说明上传成功。

九、学习建议

刚开始不要急着学分支、合并、rebase、冲突解决。你先把下面这条主线熟练：

bash 复制代码

本地文件 -> git add -> git commit -> git push -> GitHub

这条线熟了之后，再学：

bash 复制代码

git clone
git pull
git branch
git merge
.gitignore

你现在只要能稳定完成"本地项目上传GitHub"，就已经入门了。