git

从 VS Code 创建项目并使用 SSH 推送到 GitHub

您可以完全在 Visual Studio Code (VS Code) 中完成项目的初始化，并将其通过更安全、更便捷的 SSH 方式推送到全新的 GitHub 仓库。

以下是详细的步骤指南，涵盖了从生成 SSH 密钥到最终代码推送的全过程。

第一步：配置 SSH 密钥（如果尚未配置）

要使用 SSH 协议，您的电脑需要一个 SSH 密钥对，并且需要将公钥添加到您的 GitHub 账户中。

1. 检查现有 SSH 密钥：
   打开终端（在 VS Code 中可以通过 Terminal > New Terminal 打开），输入以下命令检查是否已有 SSH 密钥：

   ls -al ~/.ssh
   

   如果列表中包含 id_rsa.pub 或 id_ed25519.pub 等文件，说明您已经有密钥了，可以跳到第 3 步。

2. 生成新的 SSH 密钥：
   如果没有任何 .pub 文件，请运行以下命令生成新的密钥。建议使用 Ed25519 算法：

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

   替换为您的 GitHub 邮箱地址。 系统会提示您保存文件（直接按 Enter 接受默认位置）和设置密码（可选，可直接按 Enter 跳过）。

3. 将 SSH 公钥添加到 GitHub：

   • 首先，复制您的公钥内容。在终端输入以下命令并复制其输出：

     cat ~/.ssh/id_ed25519.pub
     

   • 登录您的 GitHub 账户，进入 Settings > SSH and GPG keys。
   • 点击 New SSH key，为密钥起一个标题（例如“My VS Code Mac”），然后将复制的公钥内容粘贴到 “Key” 文本框中，最后点击 Add SSH key。

4. 测试 SSH 连接：
   在终端中运行以下命令，验证连接是否成功：

   ssh -T git@github.com
   

   如果看到 “Hi [Your Username]! You've successfully authenticated...”，则说明您的 SSH 配置成功。

第二步：在 VS Code 中初始化本地仓库

1. 打开或创建项目文件夹：
   在 VS Code 中，通过 File > Open Folder... 打开您的项目文件夹。如果是一个全新的项目，可以先创建一个空文件夹再打开它。

2. 初始化 Git 仓库：

   • 点击 VS Code 左侧活动栏的 Source Control (源代码管理) 图标。
   • 您会看到一个 Initialize Repository (初始化仓库) 的按钮，点击它。
   • 这将在您的项目文件夹中创建一个 .git 目录，标志着本地仓库创建成功。

第三步：在 GitHub 上创建新的远程仓库

1. 登录 GitHub：
   在浏览器中访问您的 GitHub 账户。

2. 创建新仓库：
   点击页面右上角的 + 号，选择 New repository。

   • 为您的仓库命名（Repository name）。
   • 关键：不要勾选初始化选项，如 Add a README file, Add .gitignore, 或 Choose a license。因为我们稍后会从本地推送这些文件。
   • 点击 Create repository。

3. 复制 SSH URL：
   在仓库创建成功后的页面上，确保选择的是 SSH 协议，然后复制提供的仓库 URL。它应该看起来像 git@github.com:YOUR_USERNAME/YOUR_REPOSITORY.git。

第四步：连接本地仓库并推送

1. 添加远程仓库地址：
   回到 VS Code 的终端，运行以下命令，将您刚才复制的 SSH URL 添加为名为 origin 的远程仓库：

   git remote add origin git@github.com:YOUR_USERNAME/YOUR_REPOSITORY.git
   

2. 进行首次提交 (Commit)：

   • 在 Source Control 面板，您会看到项目中的所有文件都列在 “Changes” 下。
   • 在文件列表上方的输入框中填写您的首次提交信息，例如 “Initial commit”。
   • 点击复选标记 ✔️（Commit 按钮）来提交您的更改。

3. 推送代码到 GitHub：

   • 提交后，VS Code 左下角的状态栏可能会出现一个带有云和向上箭头的图标，点击它可以直接推送。
   • 或者，在终端中运行以下命令，将您的 main (或 master) 分支推送到远程的 origin 仓库：

     git push -u origin main
     

     （如果您的主分支是 master，请将 main 替换为 master）

完成以上步骤后，刷新您在 GitHub 上的仓库页面，您应该能看到所有本地项目文件都已成功上传。现在，您的 VS Code 项目已经与 GitHub 仓库通过 SSH 建立了连接，未来的所有 Git 操作都将通过这种安全的方式进行。