2025-09-09 10:29:50 +08:00
# 第一章. 概述 （ ）
本章旨在帮助初学者快速掌握现代软件开发中必备的三大基础工具：版本控制系统 Git 与代码托管平台 Gitee、集成开发环境 IntelliJ IDEA， ， ，
---
## 任务1：
### **目标**
掌握基本的 Git 命令行操作，理解分布式版本控制的核心概念，并能在 Gitee 平台上创建、克隆、推送和管理代码仓库。
### **步骤**
#### **步骤 1：
1. **访问官网** ：打开浏览器，访问 Git 官方下载页面：[https://git-scm.com/download/win ](https://git-scm.com/download/win )。
2. **下载安装** ：页面会自动检测你的系统并提供合适的 64 位或 32 位安装包。点击下载按钮，等待下载完成。
3. **运行安装** ：双击下载好的 `.exe` 文件启动安装向导。
4. **保持默认** ： ， ， （ ）
5. **验证安装** ：安装完成后，可以在开始菜单中搜索并打开 “Git Bash”。在弹出的黑色窗口中输入 `git --version` 并按回车，如果显示版本号（如 `git version 2.xx.x.windows.1` ），则说明安装成功。
#### **步骤 2：
- **访问网站** ：打开浏览器，访问 Gitee 官网：[https://gitee.com ](https://gitee.com )。
- **注册账号** ： （ ） ，
#### **步骤 3：
1. **登录账号** ：使用刚注册的账号登录 Gitee。
2. **新建仓库** ：登录后，点击页面右上角的“+”号，然后选择“新建仓库”。
3. **配置仓库** ：
* **仓库名称** ：输入 `test` 。
* **仓库路径** ：系统会自动生成，通常为你的用户名/test。
* **仓库介绍** ：
* **仓库可见性** ：选择 **私有仓库** （ ） ，
* **初始化仓库** ：
* 勾选 **添加 .gitignore 文件** ，并在下拉菜单中选择 `Java` 。这会自动忽略编译生成的 `.class` 文件等。
* 勾选 **添加 README.md 文件** 。这会为你创建一个项目说明文档。
* **分支模型** ： （ ）
* **项目语言** ：选择 **Java** 。
4. **创建仓库** ：检查无误后，点击底部绿色的“创建”按钮。
#### **步骤 4：
1. **打开终端** ：在你的电脑上，打开 Git Bash（ ）
2. **进入工作目录** ：假设你想将项目放在 `D:\javaweb` 目录下，先确保该目录存在。然后执行以下命令进入该目录：
```bash
cd /d/javaweb
# 或者在 PowerShell 中: cd D:\javaweb
```
3. **执行克隆** ：在 Gitee 的仓库页面，找到“克隆/下载”按钮，复制 **HTTPS** 地址（形如 `https://gitee.com/你的用户名/test.git` ）。在终端中输入以下命令进行克隆：
```bash
git clone https://gitee.com/你的用户名/test.git
```
请务必将 `你的用户名` 替换为你在 Gitee 注册的实际用户名。
4. **进入项目** ：克隆完成后，会生成一个名为 `test` 的文件夹。使用 `cd` 命令进入该目录：
```bash
cd test
```
#### **步骤 5：
1. **创建目录** ：在 Windows 文件资源管理器中，导航到 `D:\javaweb\test` 目录，右键点击空白处，选择“新建” -> “文件夹”，将新文件夹命名为 `tasks` 。
2. **创建文件** ：进入 `tasks` 文件夹，右键点击空白处，选择“新建” -> “文本文档”，将文件命名为 `chapter01-tasks.md` 。注意，如果系统默认隐藏了文件扩展名，你需要确保文件名是 `chapter01-tasks.md` ，而不是 `chapter01-tasks.md.txt` 。
3. **拷贝内容** ： （ ） ， （ ） （ ） `chapter01-tasks.md` 文件， （ ）
#### **步骤 6：
现在，你本地仓库有了新的文件和目录，但远程仓库还没有。你需要将这些改动“提交”并“推送”上去。
1. **添加到暂存区** ：在 Git Bash 或 PowerShell 中（确保你当前在 `test` 目录下），执行以下命令，将所有新增和修改的文件添加到暂存区：
```bash
git add .
```
2. **提交到本地仓库** ：执行提交命令，为这次改动添加一条描述信息：
```bash
git commit -m "添加 chapter01-tasks.md 文件"
```
3. **推送到远程仓库** ：将本地的提交推送到 Gitee 的 `master` 分支：
```bash
git push origin master
```
首次推送时，系统可能会弹出一个窗口要求你输入 Gitee 的用户名和密码（或个人访问令牌）。
4. **验证推送** ：刷新你的 Gitee 仓库网页，你应该能看到新创建的 `tasks` 目录和里面的 `chapter01-tasks.md` 文件。
#### **步骤 7：
1. **打开文件** ：在文件资源管理器中，找到 `test` 目录下的 `README.md` 文件，
2. **编辑内容** ：在文件末尾或开头添加一些内容，例如：
```markdown
# 项目简介
这是一个用于练习 Git 的 Java 项目。
## 学习目标
- 掌握 Git 基础命令
- 熟悉 Gitee 平台操作
```
#### **步骤 8：
1. **添加修改** ：回到终端，执行 `git add` 命令，专门添加修改过的 `README.md` 文件：
```bash
git add README.md
```
2. **提交修改** ：提交这次修改：
```bash
git commit -m "更新 README.md，
```
3. **推送修改** ：再次推送到远程仓库：
```bash
git push origin master
```
这次推送应该不会再要求输入密码（如果系统记住了你的凭据）。
#### **步骤 9：
在终端中，输入以下命令查看你的提交历史：
```bash
git log
```
你会看到一个列表，显示了你所有的提交记录，包括提交的哈希值、作者、日期和提交信息。按 `Q` 键可以退出日志查看界面。
---
## 任务2： （
### **目标**
熟悉 IntelliJ IDEA 的安装与基本配置，并掌握如何在 IDE 的图形化界面中进行 Git 操作，如提交、推送、克隆等，提升开发效率。
### **步骤**
1. **下载 IDEA** ：访问 JetBrains 官网的 IntelliJ IDEA 下载页面：[https://www.jetbrains.com/idea/download/ ](https://www.jetbrains.com/idea/download/ )。选择 **Community Edition（ ） ，它是免费且开源的，对于学习和大多数 Java 开发来说完全足够。点击下载适用于 Windows 的 `.exe` 安装包。
2. **安装 IDEA** ：双击下载的安装文件，启动安装向导。同样，建议大部分选项保持默认，只需选择安装路径（例如 `C:\Program Files\JetBrains\IntelliJ IDEA Community Edition` ）即可。安装过程中会提示创建桌面快捷方式，建议勾选。
3. **首次启动与配置** ：
* 安装完成后，双击桌面图标启动 IDEA。
* **导入设置** ：如果是首次启动，会询问是否导入设置，选择 “Do not import settings”。
* **接受协议** ：阅读并接受用户协议。
* **选择主题** ：在 “UI Theme” 选择你喜欢的主题（如 “IntelliJ Light” 或 “Darcula”）
* **安装插件** ：在插件市场页面，可以先跳过，稍后再安装。
* **启动 IDE** ：点击 “Start using IntelliJ IDEA”。
4. **打开项目** ：在 IDEA 的欢迎界面，点击 “Open” 或 “Open or Import”。导航到你之前克隆的项目目录 `D:\javaweb\test` ，选中它并点击 “OK”。IDEA 会将此目录识别为一个项目并打开。
5. **编辑文件** ：在 IDEA 左侧的 “Project” 面板中，找到并双击 `README.md` 文件。在编辑器中，继续为其添加一些内容，例如：
```markdown
## 开发环境
- JDK 17
- IntelliJ IDEA 2023.x
```
6. **使用 IDEA 的 Git 菜单推送** ：
* 编辑完成后，你会看到 `README.md` 文件名在项目面板中变为蓝色，表示它已被修改。
* 右键点击项目根目录或 `README.md` 文件，选择 “Git” -> “Commit File...”。
* 在弹出的 “Commit Changes” 窗口中，确保 `README.md` 在 “Changes” 列表中被选中。在下方的 “Commit Message” 输入框中输入提交信息， ：
* 点击 “Commit and Push” 按钮（或先点 “Commit”， ）
* 在 “Push Commits” 对话框中，确认要推送到 `origin/master` ，然后点击 “Push”。IDEA 会执行推送操作，并在底部的 “Version Control” 工具窗口中显示操作日志。
7. **关闭项目** ：点击 IDEA 菜单栏的 “File” -> “Close Project”。这会关闭当前项目，
8. **删除本地文件夹** ：打开 Windows 文件资源管理器，找到 `D:\javaweb\test` 文件夹，将其删除。这模拟了项目丢失或需要在新机器上重新获取代码的场景。
9. **从版本控制克隆项目** ：
* 在 IDEA 欢迎界面，点击 “Get from VCS”（ ）
* 在 “URL” 输入框中，粘贴你的 Gitee 仓库的 HTTPS 地址（`https://gitee.com/你的用户名/test.git` ）。
* 在 “Directory” 中，选择一个本地路径，例如 `D:\javaweb\test` 。
* 点击 “Clone”。IDEA 会自动调用 Git 命令克隆仓库，并在克隆完成后直接打开项目。
10. **熟悉 IDEA 中的 Git 操作** ：
* 在项目中，尝试修改一个文件。
* 观察 “Project” 面板中的文件颜色变化。
* 使用 “VCS” 菜单（或右键菜单）进行 “Commit”、“Push”、“Pull”、“Show History” 等操作。
* 打开底部工具栏的 “Version Control” 标签页，这里会显示本地更改、日志和推送/拉取的状态。
---
## 任务3：
### **目标**
熟悉 Markdown 的基本语法规则，能够使用它来编写结构清晰、格式美观的文档，并将其应用于项目中的 `README.md` 和任务文件。
### **步骤**
1. **继续操作** ：确保你已经在 IntelliJ IDEA 中打开了 `test` 项目。
2. **编辑任务文件** ：在 “Project” 面板中，导航到 `tasks/chapter01-tasks.md` 文件并双击打开。此时，文件内容是你之前从本指南拷贝过去的纯文本。
3. **应用 Markdown 语法** ：现在，你需要将这份纯文本“美化”成标准的 Markdown 格式。例如：
* 将 `# 第一章. 概述 （ ） 保留，它已经是正确的 Markdown 一级标题。
* 将 `## 任务1： 保留，它是二级标题。
* 将 `- **目标**： 修改为：
```markdown
- **目标**：掌握基本的 Git 命令和 Gitee/Github 的使用。
```
（这里主要是调整了空格，使其更规范）
* 将 `### **步骤 1： 修改为：
```markdown
### 步骤 1：
```
（去掉 `**` ，因为 `###` 本身已经是标题，加粗是多余的）
* 将编号列表 `1. 访问 Git 官网...` 保留，
* 将代码块用 \`\`\`bash 和 \`\`\` 包裹起来。
* 你可以根据自己的理解，为文档添加更多层级的标题、列表、加粗、斜体等。
4. **编辑 README.md** ：打开项目根目录的 `README.md` 文件，使用 Markdown 语法为其添加更丰富的内容。例如，可以添加一个表格来列出项目成员，或添加一个链接指向 Gitee 官网。
```markdown
[Gitee 官网 ](https://gitee.com )
```
5. **提交修改** ：
* 在 IDEA 中，你会看到 `chapter01-tasks.md` 和 `README.md` 都显示为已修改。
* 右键点击项目根目录，选择 “Git” -> “Commit Directory...”。
* 在 “Commit Changes” 窗口中，勾选这两个文件。
* 在提交信息中输入：
* 点击 “Commit and Push”，
---
## 增强任务4：
### **目标**
配置 SSH 密钥对，实现与 Gitee 仓库的免密码安全连接，简化后续的 `git push` 和 `git pull` 操作。
### **步骤**
1. **生成 SSH 密钥** ：
* 在 Windows 上，打开 **PowerShell** （以管理员身份运行不是必须的，但有时能避免权限问题）。
* 输入以下命令并按回车：
```bash
ssh-keygen -t ed25519 -C "your_email@example .com"
```
* `-t ed25519` ：指定使用更现代、更安全的 Ed25519 算法。如果系统不支持，可以使用 `-t rsa -b 4096` 。
* `-C "your_email@example.com"` ：将 `your_email@example.com` 替换为你在 Gitee 注册时使用的邮箱，这是一个注释，方便你识别密钥。
* **设置密钥保存路径** ：系统会提示 `Enter file in which to save the key` 。直接按回车，接受默认路径（通常是 `C:\Users\你的用户名\.ssh\id_ed25519` ）。
* **设置密码短语（ ） ：接下来会提示 `Enter passphrase` 。为了实现“免密”访问，这里直接按两次回车，不设置任何密码。*（注意：在生产环境中，强烈建议设置一个密码短语以增加安全性，但对于学习环境可以省略）*。
* **完成** ：成功后，你会看到类似 `Your public key has been saved in ...` 的提示。
2. **获取公钥内容** ：
* 打开文件资源管理器，导航到 `C:\Users\你的用户名\.ssh\` 目录。
* 找到名为 `id_ed25519.pub` 的文件（如果你用的是 RSA 算法，则是 `id_rsa.pub` ）。
* 用记事本打开这个 `.pub` 文件。
* 全选文件内的所有内容（从 `ssh-ed25519` 或 `ssh-rsa` 开始， ） ， （ ）
3. **在 Gitee 添加公钥** ：
* 登录你的 Gitee 账号。
* 点击右上角的用户头像，在下拉菜单中选择 “**账号设置**”。
* 在左侧菜单栏中，找到并点击 “**SSH 公钥**”。
* 点击 “**添加公钥**” 按钮。
* 在 “**公钥标题**” 输入一个容易识别的名字，例如 “My Windows PC”。
* 在 “**公钥内容**” 的大文本框中，粘贴你刚才复制的公钥内容。
* 点击 “**确定**” 按钮保存。
4. **测试 SSH 连接** ：
* 回到 PowerShell， ：
```bash
ssh -T git@gitee .com
```
* 如果是第一次连接，系统会询问 `The authenticity of host 'gitee.com (xx.xx.xx.xx)' can't be established... Are you sure you want to continue connecting (yes/no/[fingerprint])?` ，输入 `yes` 并回车。
* 如果配置成功，你会看到类似 `Hi 你的用户名! You've successfully authenticated, but GITEE.COM does not provide shell access.` 的欢迎信息。
5. **使用 SSH 地址克隆/操作仓库** ：
* 现在，你可以使用 SSH 地址来与你的仓库交互，而无需每次都输入用户名和密码。
* 回到你的 `D:\javaweb` 目录，删除旧的 `test` 文件夹（如果还存在）。
* 在 Gitee 仓库页面，点击“克隆/下载”，这次选择 **SSH** 标签页，复制 SSH 地址（形如 `git@gitee.com:你的用户名/test.git` ）。
* 在 PowerShell 或 Git Bash 中执行克隆：
```bash
cd /d/javaweb
git clone git@gitee .com:你的用户名/test.git
```
* 之后，所有在 `test` 仓库目录下的 `git pull` , `git push` 等操作都将通过 SSH 进行，实现免密访问。
恭喜你！至此，你已经完成了第一章的所有任务，为后续的 Java Web 开发打下了坚实的工具基础。
