【已解决】（2025新）如何在 GitHub 上传项目 | 图文超详细教程手把手教你适合小白新手从零开始

最新推荐文章于 2025-04-03 09:58:57 发布

Kika写代码

最新推荐文章于 2025-04-03 09:58:57 发布

阅读量1k

点赞数 46

文章标签： github

本文链接：https://blog.youkuaiyun.com/m0_73972962/article/details/146048441

版权

第一步：准备工作

注册 GitHub 账号
- 访问 GitHub 官网
- 点击右上角 Sign Up，填写邮箱、密码等信息注册账号。
安装 Git
- Git 是一个版本控制工具，用于管理你的代码。
- 参考：【已解决】（2025新） Git 下载安装配置图文超详细教程手把手教你小白-优快云博客

第二步：配置 Git

打开命令行工具
- Windows：按 Win + R，输入 cmd 回车。
- Mac：打开终端（在“应用程序-实用工具”中）。

设置用户名和邮箱（重要！）

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

假设你的 GitHub 账户信息如下：

用户名: Kkkika

注册邮箱:

在命令行中执行：

第三步：创建本地项目

新建一个项目文件夹
- 例如：在桌面创建文件夹my-project（命名根据需要即可），将你的代码文件放入其中。
- 确保文件夹内包含你的项目文件（如 .html, .js, 图片等）。

第四步：初始化 Git 仓库

在命令行中进入项目文件夹

cd Desktop\my-project  # 替换为你的实际路径

初始化 Git
```
git init
```

这会创建一个隐藏的 .git 文件夹，用于跟踪代码变化。

第五步：将文件添加到 Git

添加所有文件到暂存区
```
git add .
```
- git add . 表示添加当前目录所有文件。
- 如果只想添加特定文件，可以用 git add 文件名。
提交文件到本地仓库
```
git commit -m "第一次提交，初始化项目"
```
- -m 后面的内容是提交说明，建议简单描述改动内容。

第六步：在 GitHub 创建远程仓库

登录 GitHub，点击右上角 ➕ → New repository
填写仓库信息
- Repository name: 输入仓库名（如 my-project）。
- Description: 可选，写一句项目描述。
- 选择 Public（公开，免费）。
- 勾选 Add a README file（可选，建议勾选）。
点击 Create repository。

第七步：将本地代码推送到 GitHub

关联远程仓库

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

例如：

git remote add origin https://github.com/Kkkika/weapp-starter-cartoon.git

推送代码到 GitHub
```
git push -u origin master
```
- 输入你的 GitHub 账号密码（如果提示）。

这是 GitHub 的设备代码认证界面。其作用是通过设备代码的方式来完成用户身份验证。

信息解释

标题：“Device code authentication”，表明这是设备代码认证窗口。
说明文字：“Visit the URL below, sign in, and enter the following device code to continue.”，提示用户访问下方给出的链接，登录自己的 GitHub 账户，然后输入设备代码以继续操作。
设备代码：图中显示的 “05EF - 43EF” 就是此次需要输入的设备代码。
链接：“Sign in to GitHub · GitHub”，这是用户需要访问进行认证操作的网页地址。

推送结果：

To https://github.com/Kkkika/weapp-starter-cartoon.git 显示了远程仓库的地址。
* [new branch] master -> master 表示本地的 master 分支作为新分支被推送到了远程仓库的 master 分支。
branch 'master' set up to track 'origin/master'.：本地的 master 分支已设置为跟踪远程的 origin/master 分支。

第八步：验证是否成功

刷新你的 GitHub 仓库页面，应该能看到上传的文件！

第九步：想更新代码？

修改文件后，重复以下步骤：

git add .
git commit -m "更新描述"
git push

git add .
git commit -m "添加新功能"
git push origin master

常见问题

提示密码错误？
- GitHub 现在需用 Token 代替密码：
  1. 进入 GitHub → Settings → Developer settings → Personal Access Tokens → Generate new token。
  2. 勾选 repo 权限，生成 Token 后复制。
  3. 在命令行粘贴 Token 作为密码。

执行 git push 命令时遇到错误的提示信息？

以下是解决 git push 被拒绝问题的完整方案，包含原理说明、操作步骤和预防措施：

原因：远程仓库存在本地没有的新提交（可能是他人推送，或你在其他设备/网页端的操作）；或者本地提交历史与远程提交历史不在同一条时间线上。

# 1. 拉取远程更新并自动合并
git pull origin master

# 2. 解决可能出现的代码冲突
#    - 用编辑器打开冲突文件（搜索 <<<<<<< 标记）
#    - 手动选择保留哪些代码
#    - 删除冲突标记（<<<<<<<, =======, >>>>>>>）

# 3. 提交合并后的代码
git add .
git commit -m "合并远程更新"

# 4. 重新推送
git push origin master