GitHub 项目上传实操指南：网页与命令行方式

如果没安装 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

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）了！

这步常见问题解答

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" 里