前言

​​“想象一下：​​ 你写了一段超酷的代码，想分享给朋友；或者你在网上发现了一个超有用的脚本，想存下来研究改进；又或者导师让你从一个叫‘GitHub’的地方拉取代码…… ​​所有这些操作，都绕不开——注册、上传文件和下载文件这几个最最基础的环节。​​

​​没错！GitHub 不只是‘大神们’协作的神秘工具，它更是每个开发者/学习者都该掌握的‘数字文件柜’和‘项目通行证’！​​ 但第一步的门槛，常常让新手望而却步。

​​这份指南的目的很简单：​​ ​​帮你无痛迈过这第一步！​​ 我们将一步步演示：

​​如何像开邮箱一样​​ 轻松注册 GitHub

​​如何像建文件夹一样​​ 创建你的项目仓库

​​如何像网盘上传一样​​ 把本地文件放进仓库

​​如何像保存附件一样​​ 把仓库里的文件下载到本地

​必须准备 ​

⚠️ ​​关键一步！​​

​​安装加速器​​（否则可能无法加载页面）：

1.下载Watt Toolkit→ 安装完成后，打开勾选 GitHub→ 点击 ​​"一键加速"​​

2.其他加速器同理，确保 GitHub 域名畅通

建立一个测试文件（如 hello.txt，要包含内容）

一、GitHub 注册与登录

（一）注册账号

加完速后，打开浏览器，访问 GitHub 官方网站（https://github.com/ ）。点击页面右上角的 “Sign up”（注册）按钮。在注册页面，填写个人信息：

Username：自定义唯一的用户名，用于标识你的 GitHub 账号，后续也会出现在仓库地址中。Email ：填写常用邮箱，用于账号验证、接收通知 。Password：设置安全密码，建议包含大小写字母、数字和特殊字符 。 完成信息填写后，点击 “Create account”（创建账号），随后可能需要通过邮箱验证，登录邮箱点击验证链接即可完成注册。

（二）登录账号

注册完成后，回到 GitHub 首页，点击右上角 “Sign in”（登录），输入注册时的用户名 / 邮箱和密码，即可登录进入 GitHub 个人主页。

（三）创建 GitHub 仓库

登录后，点击页面右上角 “+” 号，选择 “New repository”（新建仓库）：

Repository name：填写仓库名称，如 “RTOS-Button-Led-Servo-Motor” ，自定义且体现仓库用途。Description（可不填）：简单描述仓库，说明项目功能、用途等，方便他人了解。Visibility：选择仓库可见性，“Public”（公开）则任何人可访问，“Private”（私有）仅授权用户可访问 。可根据需求勾选初始化选项（如添加 README 文件、.gitignore 文件等），点击 “Create repository” 完成仓库创建。

二、本地环境准备（安装 Git）

（一）下载与安装 Git

访问 Git 官方网站（Git - Downloads ），根据操作系统（Windows、macOS、Linux ）下载对应安装包。

Windows：运行安装包，按向导默认选项安装即可，完成后可通过 “Git Bash” 使用 Git 命令。macOS：可通过官方安装包或 Homebrew（brew install git ）安装，终端中输入 git --version 验证是否安装成功。Linux（以 Ubuntu 为例）：打开终端，执行 sudo apt update && sudo apt install git 安装，同样用 git --version 检查。

这里演示的是Windows版本，点击网站进去后点击这里的Download for Windows，进入后点击Click here download下载即可

（二）配置 Git 身份

打开终端，执行以下命令配置与 GitHub 关联的用户名和邮箱（替换为注册 GitHub 的信息）：

git config --global user.name "你的GitHub用户名"

git config --global user.email "注册GitHub的邮箱"

在终端输入这几段代码可以显示Git 已配置的信息

//查看全局配置的用户名

git config --global user.name

//查看全局配置的邮箱

git config --global user.email

//查看所有 Git 全局配置

git config --global --list

三、上传本地项目到 GitHub 仓库

（一）初始化本地 Git 仓库

假设你要上传的项目文件在文件夹test里面，可以直接在文件夹里吗，打开终端，或者通过 cd 命令进入你要上传的项目目录：

cd D:\360MoveData\Users\lenovo\Desktop\test

执行初始化本地 Git 仓库，会在项目目录生成隐藏的 .git 文件夹，用于跟踪文件变化。

//初始化仓库

git init

（二）添加文件到暂存区

将项目文件添加到 Git 暂存区，执行（注意这里的 . 是和add隔了一个空格）：

git add .

这里 . 表示添加当前目录下所有文件，也可指定单个文件（如 git add 文件名 ）。

（三）提交文件到本地仓库

提交暂存区文件到本地仓库，并填写提交说明（描述本次提交内容，乱码的话就换成英文）：

git commit -m "Initial commit：初始化项目，上传TIME_PWM_LED相关文件"

（四）关联远程 GitHub 仓库

在 GitHub 仓库页面，复制仓库的 HTTPS 或 SSH 地址（以 HTTPS 为例）。执行以下命令关联远程仓库（替换为实际仓库地址）（打开新建仓库，点击Code，复制HTTP地址）：

git remote add origin https://github.com/tycrsg/wahaha.git

（五）推送文件到远程仓库

执行推送命令，将本地仓库内容推送到 GitHub 远程仓库：

git push -u origin master

若仓库默认分支是 main ，则替换 master 为 main 。首次推送加 -u 可建立本地与远程分支的跟踪关系，后续推送可直接用 git push 。

这里失败后可能是网络配置一些相关的问题，可以直接转入SSH 连接 GitHub：

（六）转ssh连接github

1.生成 SSH 密钥（已生成可跳过）：

ssh-keygen -t ed25519 -C "你的GitHub邮箱"

一路按回车默认即可，密钥会保存在 ~/.ssh 目录（Windows 为 C:\Users\你的用户名\.ssh）。

2.复制公钥内容：

Windows：用记事本打开 C:\Users\你的用户名\.ssh\id_ed25519.pub，复制全部内容。

macOS/Linux：执行 cat ~/.ssh/id_ed25519.pub 并复制输出。

3.添加到 GitHub：

登录 GitHub → 点击头像 →“Settings”→“SSH and GPG keys”→“New SSH key”。

粘贴公钥，取个名字（如 “我的电脑”），点击 “Add SSH key”。

4.更换远程仓库地址为 SSH 格式（打开新建仓库，点击Code，复制SSH地址）：

git remote set-url origin git@github.com:tycrsg/wahaha.git

5.再次推送：

这次就成功推送到了你的仓库里面（由于我这里是空文件，所以没有显示出来，但是有分支）。

git push -u origin master

四、从 GitHub 仓库下载文件

（一）克隆仓库到本地（完整下载）

在 GitHub 仓库页面复制仓库地址（HTTPS 或 SSH），打开终端，用cd命令进入要保存项目的目录，或者直接去桌面创建一个新文件夹，在里面打开终端，执行克隆命令：

git clone https://github.com/tycrsg/RTOS-Button-Led-Servo-Motor.git

会在当前目录创建与仓库同名的文件夹，下载仓库所有文件。

（二）拉取仓库更新（已有本地仓库时）

若本地已克隆过仓库，后续仓库有更新，进入本地仓库目录，执行：

git pull origin master

将远程仓库最新内容拉取到本地，保持与远程同步（分支名按需替换，如 main ）。

（三）下载单个文件 / 文件夹（网页端操作）

在 GitHub 网页仓库中，找到要下载的文件，点击文件进入详情页，右上角点击 “Code” 直接下载zip文件即可。

五、注意事项与常见问题

（一）大文件提示

上传大文件（如你遇到的视频超过 50MB 提示 ），可使用 Git LFS（Large File Storage）管理，安装 LFS 后（git lfs install ），通过 git lfs track "大文件扩展名" 跟踪大文件，再正常提交推送。

（二）网络与代理问题

推送 / 拉取时若遇网络连接错误（如代理导致无法连接 ），可检查 Git 代理配置（git config --global --unset http.proxy 等命令清除无效代理），或切换网络（如手机热点）尝试，或者直接使用SSH连接。

通过以上步骤，即可完成 GitHub 从注册、仓库创建，到本地项目上传、远程仓库下载的完整流程，轻松管理你的代码和项目资源