-
Github上传项目(手把手实操版),简单易学!
2025-12-19 01:35:59
原创文章|转载请注明出处 作者:YTHX516
方法1:通过 GitHub 网页上传文件(小文件使用 <25MB)
1.登录 GitHub 打开 https://github.com 并登录你的账户。
2.进入目标仓库(Repository) 点击你要上传文件的项目仓库。
3.点击 "Add file" 按钮
在仓库页面中,点击绿色的 “Code” 按钮旁边的 “Add file” → 选择 “Upload files”。
4.拖拽文件或选择文件
你可以将本地文件直接拖到页面上,或者点击 “choose your files” 手动选择。
5.填写提交信息(Commit message)
比如写 “上传初始文件” 或 “添加README文档”。
6.点击 "Commit changes" 点击 "提交更改"
然后点击绿色按钮完成上传。
7.成功!
方法二:通过 Git 命令行上传文件(较大文件使用 <100MB)
1.安装配置Git
如果没安装 Git,请先下载:Git - Downloads
Git 需要你配置一次你的身份信息,用于记录每次提交是谁做的。
git config --global user.name "你的用户名" git config --global user.email "你的邮箱地址"
举个例子!
git config --global user.name "YTHX516" git config --global user.email "YTHX516@example.com"
检查设置是否成功:
git config --list
2.在 GitHub 上新建一个仓库
登录 GitHub → 点击右上角“+” → 选择 “New repository”
填写仓库名称,比如 my-upload-demo。按照需求选择,然后点击 “Create repository”
3.打开 CMD 命令行窗口
法1:快捷方式:按下 Win + R 打开“运行”窗口,输入 cmd,然后按下回车键
法2:开始菜单:点击开始菜单 → 搜索 “命令提示符” 或 “CMD”,右键点击 → “以管理员身份运行”(可选)
⚠️ 如果你使用的是 Git Bash、PowerShell 或 VS Code 的终端,也可以完成以下步骤。
4.克隆仓库到本地
这一步的目的是把 GitHub 上的项目复制一份到你电脑上,方便我们在本地添加文件并进行管理。
在仓库网址处复制生成的 HTTPS 地址
比如:
https://github.com/你的用户名/my-upload-demo.git
执行克隆命令
git clone https://github.com/你的用户名/my-upload-demo.git
⚠️ 替换成你真实的仓库地址!
成功后你会看到:
Cloning into 'my-upload-demo'...
进入项目目录(记得更换为你的项目名)
cd my-upload-demo
5.把你要上传的文件放到这个文件夹
将你电脑上的文件,比如 README.md、图片、压缩包等,移动到本地 Git 项目文件夹中,准备上传到 GitHub。
🧭前置说明:什么是“项目文件夹”?
当你执行了 git clone https://github.com/xxx/xxx.git 命令后,Git 会在你当前目录下创建一个新文件夹这个文件夹就是你项目的本地副本(本地仓库)所有文件必须放在这个文件夹里,Git 才能追踪并上传到 GitHub
你已经在命令行中 cd 到项目目录,接着输入
explorer .
explorer . 的意思是:用 Windows 资源管理器打开当前目录。
将文件拖进打开的文件夹窗口
找到你要上传的文件,直接拖动文件到打开的文件夹中,或者复制粘贴也可以(右键 → 复制 → 粘贴)!
检查是否放入成功?
可以用命令行查看你当前文件夹内容:
dir
它会列出你刚刚拷贝进来的文件,确认无误就可以进行下一步(add/commit/push)了!
这步常见问题解答
问题解决方案不知道 clone 下来在哪个盘?在命令行输入 cd 回车,看当前路径资源管理器打不开?检查命令是否是 explorer .(注意有空格)拖进来文件后找不到?用 dir 命令查看是否确实放在了正确目录
6.使用 Git 命令把文件上传到 GitHub
添加文件到 Git 的追踪区(staging area)
在命令行中,确保你已经位于项目目录下
cd my-upload-demo
然后输入:
git add .
git add . 中的 . 表示添加“当前目录下的所有文件”
如果你只想添加某个文件,也可以用:
git add README.md
git add images/logo.png
提交文件,写入一条更新记录
输入以下命令(引号里的文字可以改成你自己的描述):
git commit -m "上传初始文件,包括 README 和资源文件"
建议简单明了地描述你上传的内容,例如:
初始化项目上传演示图片和README添加压缩包和图片素材
Git 会保存这条提交记录,在 GitHub 上也能看到。
将更改推送到 GitHub
这是最重要的一步,把你在本地的更改同步到 GitHub 网站上:
git push origin main
如果你用的是 master 分支(早期默认分支名),请用:
git push origin master
7.如何确认上传成功?
打开 GitHub 网站进入你上传文件的仓库页面你会看到:
新上传的文件和文件夹都已经出现每个文件都可以单独查看提交信息也记录在首页和 "Commits" 里