> 技术文档 > Github上传项目(手把手实操版),简单易学!_github如何上传自己的项目

Github上传项目(手把手实操版),简单易学!_github如何上传自己的项目


原创文章|转载请注明出处
作者: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.如何确认上传成功?

  1. 打开 GitHub 网站
  2. 进入你上传文件的仓库页面
  3. 你会看到:
    • 新上传的文件和文件夹都已经出现
    • 每个文件都可以单独查看
    • 提交信息也记录在首页和 \"Commits\" 里