第一步：准备工作

注册 GitHub 账号

访问 GitHub 官网

点击右上角 Sign Up，填写邮箱、密码等信息注册账号。

安装 Git

Git 是一个版本控制工具，用于管理你的代码。

参考：【已解决】（2025新） Git 下载安装配置 图文超详细教程 手把手教你 小白-CSDN博客

第二步：配置 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 代替密码：

进入 GitHub → Settings → Developer settings → Personal Access Tokens → Generate new token。

勾选 repo 权限，生成 Token 后复制。

在命令行粘贴 Token 作为密码。

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

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

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

# 1. 拉取远程更新并自动合并

git pull origin master

# 2. 解决可能出现的代码冲突

# - 用编辑器打开冲突文件（搜索 <<<<<<< 标记）

# - 手动选择保留哪些代码

# - 删除冲突标记（<<<<<<<, =======, >>>>>>>）

# 3. 提交合并后的代码

git add .

git commit -m "合并远程更新"

# 4. 重新推送

git push origin master

忽略某些文件（如密码、临时文件）

在项目根目录创建 .gitignore 文件，写入要忽略的文件名（如 node_modules/, .env）。

按照以上步骤操作，你的项目就会成功上传到 GitHub 啦！如果有报错，可以截图具体提示，我帮你分析解决 😊