从本地到云端：将Linux文件夹上传至GitHub仓库的完整指南

从本地到云端：将Linux文件夹上传至GitHub仓库的完整指南

Git是现代软件开发中进行版本控制的基石。在深入操作之前，理解几个核心概念至关重要，这将有助于明晰每个步骤的目的。

• 仓库 (Repository)：一个项目的数据存储库，包含了项目所有的文件、文件夹以及每一次修改的完整历史记录。它分为本地仓库（在个人电脑上）和远程仓库（托管在GitHub等服务器上）。
• 提交 (Commit)：对本地仓库中文件变化的一次快照。它是一个独立的、可追溯的保存点。只有进行了提交，更改才会被正式记录在本地仓库的历史中。

本指南将详细介绍如何将一个位于Linux环境下的本地项目文件夹，首次上传到一个空的GitHub远程仓库。

基本过程：

1. 本地文件夹变为本地仓库
2. 本地仓库与远程仓库配置
3. 本地仓库进行首次的提交
4. 本地仓库变化推送远程仓库

前提条件

在开始之前，请确保已满足以下条件：

1. 拥有一个可访问的Linux命令行环境。
2. 一个已注册的GitHub账户。
3. 一个本地存在的项目文件夹。
4. 在GitHub上已创建一个空的远程仓库。创建时，请勿勾选初始化README, .gitignore或LICENSE文件。

第一部分：初始化本地Git仓库与配置

此部分操作在本地Linux终端中完成，旨在将一个普通文件夹转变为Git可管理的本地仓库，并配置必要的身份信息。

步骤 1.1: 导航至项目目录

使用cd命令进入需要上传的项目文件夹。

# 将/path/to/your-project替换为实际的项目文件夹路径
cd /path/to/your-project

步骤 1.2: 初始化仓库

此命令会在当前目录下创建一个隐藏的.git子目录，用于存放所有Git元数据和历史记录，从而将此文件夹转换为一个Git仓库。

git init

步骤 1.3: 配置提交者身份

Git要求每次提交都必须关联一个作者身份。此配置为全局设置，只需在新环境中执行一次。

• 配置用户名 (替换为您的GitHub用户名):

  git config --global user.name "your-github-username"
  

• 配置邮箱 (替换为您的GitHub注册邮箱):

  git config --global user.email "your-email@example.com"
  

第二部分：创建首次提交

在推送至远程仓库前，本地仓库必须至少包含一次提交记录。

步骤 2.1: 暂存文件

此命令会将当前目录下所有文件的快照添加到“暂存区”，为下一次提交做准备。

git add .

步骤 2.2: 提交文件

此命令将暂存区中的所有内容创建为一个新的提交，并附加一条描述性信息。这是项目历史中的第一个永久性记录点。

git commit -m "Initial commit"

第三部分：配置与GitHub的安全连接 (SSH)

为保证数据传输安全，推荐使用SSH协议。若在推送时遇到Permission denied (publickey)错误，说明本地环境与GitHub之间尚未建立信任关系。以下步骤将配置这种关系。

步骤 3.1: 生成SSH密钥对

在终端中执行以下命令，生成一个新的SSH密钥对。

# 将引号内的邮箱替换为您的GitHub注册邮箱
ssh-keygen -t ed25519 -C "your-email@example.com"

执行后，系统会提示输入保存位置和密码。建议直接连续按三次“回车键”，以使用默认设置且不设密码。

步骤 3.2: 复制公钥

公钥需要被添加到GitHub账户中。执行以下命令以显示公钥内容。

cat ~/.ssh/id_ed25519.pub

终端将输出一长串以ssh-ed25519开头的文本。完整复制这串文本。

步骤 3.3: 在GitHub添加SSH公钥

1. 登录GitHub，进入 Settings > SSH and GPG keys。
2. 点击 New SSH key。
3. 在 Title 字段中，为该密钥输入一个描述性名称（例如，My Linux Server）。
4. 在 Key 字段中，粘贴刚刚复制的完整公钥内容。
5. 点击 Add SSH key 完成添加。

第四部分：推送本地仓库至GitHub

完成以上所有配置后，即可将本地仓库内容推送至远程。

步骤 4.1: 关联远程仓库

将本地仓库与在GitHub上创建的空仓库进行关联。origin是远程地址的默认别名。

# 将URL替换为您自己仓库的SSH地址
# 该地址可在GitHub仓库页面的"Code"按钮下找到
git remote add origin git@github.com:your-github-username/your-repository-name.git

步骤 4.2: 设定主分支名称

为符合当前行业标准，建议将本地主分支命名为main。

git branch -M main

步骤 4.3: 推送至远程仓库

此命令会将本地main分支上的所有提交推送到名为origin的远程仓库。

git push -u origin main

首次连接新主机时，终端可能会出现主机真实性验证提示。输入yes并按回车即可。操作成功后，刷新GitHub仓库页面，所有文件将显示在其中。

后续操作：更新文件与同步

在完成首次上传后，日常的开发与同步流程将变得非常简洁。当在本地对项目文件进行修改后，遵循以下三步即可将变更同步至GitHub。

1. 暂存变更：
使用git add来暂存所有已修改或新创建的文件。

git add .

2. 提交变更：
创建一个新的提交来记录这次的变更，并附上有意义的描述。

git commit -m "feat: Add user authentication feature"

3. 推送变更：
将新的提交推送到远程仓库。由于之前已使用-u参数设置了上游分支，后续推送可简化为：

git push

通过重复执行这三个步骤，可以确保本地项目的每一次重要变更都被安全、有序地记录和备份在GitHub上。