从零开始将本地项目上传到 GitHub

Cmd ：ssh-keygen -t rsa -C “注册github的邮箱”

得到ssh秘钥地址，打开.pub，复制秘钥

输入进入github设置里

在想要上传的项目文件夹下打开git bash，输入以下指令：

git init

git add .

git commit -m "first commit"

git remote add origin 创建仓库的ssh地址

git push -u origin master

ChatGPT 4o生成的指示文档：

---

从零开始将本地项目上传到 GitHub

本教程将帮助你将本地项目上传到 GitHub，步骤简明易懂，适合新手。我们将涉及 Git 的基本使用，如何生成 SSH 密钥并将它添加到 GitHub，最后将本地代码推送到远程 Git 仓库。

准备工作

确保你已经安装了 Git：

在 Git 官方网站下载并安装 Git。

安装完成后，可以通过在命令行输入 git --version 来检查安装是否成功。

确保你有一个 GitHub 账号：

如果没有，请访问 GitHub 官网 注册一个账号。

---

第一步：生成 SSH 密钥

GitHub 使用 SSH 密钥来验证你的身份。为了保证安全，我们通过 SSH 而不是密码推送代码。

打开 Git Bash（Windows 用户）或者终端（Linux/macOS 用户）。

输入以下命令生成 SSH 密钥：

ssh-keygen -t rsa -C "your_email@example.com"

其中 your_email@example.com 是你在 GitHub 上注册的邮箱。

按照提示：

会询问你选择保存 SSH 密钥的文件位置，默认情况下，密钥文件保存在 ~/.ssh/id_rsa 路径下，直接按 Enter 键即可使用默认路径。

然后会要求你设置一个 密码 来保护你的密钥，可以选择设置或直接按Enter 跳过。

密钥生成完成后，你可以通过以下命令查看生成的公钥文件位置：

cat ~/.ssh/id_rsa.pub

复制终端中显示的 SSH 密钥内容。

---

第二步：将 SSH 密钥添加到 GitHub

1. 登录你的 GitHub 账号，进入 GitHub 网站首页。
2. 点击页面右上角的 头像，然后选择 Settings（设置）。
3. 在左侧栏中选择 SSH and GPG keys。
4. 点击 New SSH key 按钮，给密钥起个名字（例如：My Laptop），然后将刚才复制的 SSH 公钥粘贴到 Key 输入框中。
5. 点击 Add SSH key 完成添加。

---

第三步：将本地项目初始化为 Git 仓库

接下来，我们将把本地项目初始化为 Git 仓库，并将文件提交到 GitHub。

打开 Git Bash，进入你本地项目的文件夹：

cd /path/to/your/project

初始化 Git 仓库：

git init

这会在你的项目文件夹中创建一个 .git 文件夹，表示该文件夹是一个 Git 仓库。

---

第四步：将文件添加到暂存区并提交

将所有文件添加到 Git 仓库的暂存区：

git add .

提交文件并写下提交信息：

git commit -m "first commit"

其中 "first commit" 是提交信息，你可以根据实际情况修改。

---

第五步：将远程仓库添加为 origin

在 GitHub 上创建一个新的仓库：

1. 登录 GitHub，点击右上角的 +，选择 New repository。
2. 填写仓库名称、描述，选择公开或私有，点击 Create repository 创建。

获取 GitHub 上仓库的 SSH 地址：

1. 在新创建的仓库页面，点击 Code 按钮，选择 SSH 选项，复制提供的 SSH 地址（例如：git@github.com:your_username/your_repository.git）。

将 GitHub 仓库添加为远程仓库：

git remote add origin git@github.com:your_username/your_repository.git

这里 git@github.com:your_username/your_repository.git 是你复制的 GitHub 仓库 SSH 地址。

---

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

推送本地代码到远程 GitHub 仓库：

git push -u origin master

1. origin 是远程仓库的默认名称。
2. master 是默认的分支名称（如果你使用的是 GitHub 默认的 main 分支，请替换为 main）。

如果这是你第一次推送代码，Git 会提示你输入 GitHub 的密码。由于你使用的是 SSH 密钥进行验证，输入密码后会使用你的 SSH 密钥进行身份验证。

---

第七步：验证上传

1. 打开浏览器，访问你刚刚创建的 GitHub 仓库页面。
2. 你会看到所有的本地项目文件已经成功上传到 GitHub 上。

---

常见问题及解决方法

1. 无法推送到 GitHub：Permission Denied

• SSH 密钥添加到 GitHub 帐号。
• SSH 地址而不是 HTTPS 地址。

1. 遇到“master”分支不存在

·GitHub 默认分支已从 master 改为 main。如果你的仓库使用的是 main 分支，推送时请将 master 替换为 main。

git push -u origin main

·

1. 如何查看远程仓库地址

·你可以通过以下命令查看当前远程仓库的地址：

git remote -v

·

---

总结

通过以上步骤，你可以成功将本地项目上传到 GitHub，并进行版本管理。这个过程包括了生成 SSH 密钥、配置 GitHub、初始化本地仓库、提交代码并将其推送到远程仓库。之后，你就可以在 GitHub 上管理你的项目，进行团队协作和代码版本控制了。