GitHub 项目上传实操指南:网页与命令行方式
本文详细介绍了两种向 GitHub 上传项目的方法。方法一适用于小文件(小于 25MB),通过网页界面直接拖拽或选择文件上传,操作简单快捷。方法二适用于较大文件(小于 100MB),利用 Git 命令行工具进行克隆、添加、提交和推送操作。文章涵盖了从环境配置、仓库创建到最终验证的完整流程,并包含常见问题解答,帮助开发者快速掌握版本控制基础操作。

本文详细介绍了两种向 GitHub 上传项目的方法。方法一适用于小文件(小于 25MB),通过网页界面直接拖拽或选择文件上传,操作简单快捷。方法二适用于较大文件(小于 100MB),利用 Git 命令行工具进行克隆、添加、提交和推送操作。文章涵盖了从环境配置、仓库创建到最终验证的完整流程,并包含常见问题解答,帮助开发者快速掌握版本控制基础操作。

打开 https://github.com 并登录你的账户。
点击你要上传文件的项目仓库。
在仓库页面中,点击绿色的 'Code' 按钮旁边的 'Add file' → 选择 'Upload files'。

你可以将本地文件直接拖到页面上,或者点击 'choose your files' 手动选择。

比如写 '上传初始文件' 或 '添加 README 文档'。

然后点击绿色按钮完成上传。


如果没安装 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 "[email protected]"
检查设置是否成功:
git config --list

my-upload-demo。按照需求选择,然后点击 'Create repository'

Win + R 打开'运行'窗口,输入 cmd,然后按下回车键⚠️ 如果你使用的是 Git Bash、PowerShell 或 VS Code 的终端,也可以完成以下步骤。
这一步的目的是把 GitHub 上的项目复制一份到你电脑上,方便我们在本地添加文件并进行管理。
比如:
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

将你电脑上的文件,比如
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 命令查看是否确实放在了正确目录 |
在命令行中,确保你已经位于项目目录下
cd my-upload-demo
然后输入:
git add .
git add . 中的 . 表示添加'当前目录下的所有文件'。
如果你只想添加某个文件,也可以用:
git add README.md
git add images/logo.png

输入以下命令(引号里的文字可以改成你自己的描述):
git commit -m "上传初始文件,包括 README 和资源文件"
建议简单明了地描述你上传的内容,例如:
Git 会保存这条提交记录,在 GitHub 上也能看到。

这是最重要的一步,把你在本地的更改同步到 GitHub 网站上:
git push origin main
如果你用的是 master 分支(早期默认分支名),请用:
git push origin master



微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online
通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online
将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online