261 lines
17 KiB
Markdown
261 lines
17 KiB
Markdown
# 第一章. 概述 （90分钟）
|
||
|
||
本章旨在帮助初学者快速掌握现代软件开发中必备的三大基础工具：版本控制系统 Git 与代码托管平台 Gitee、集成开发环境 IntelliJ IDEA，以及轻量级文档标记语言 Markdown。通过三个核心任务和一个增强任务，你将在90分钟内完成从环境搭建、账号注册、仓库操作，到在专业 IDE 中进行可视化 Git 管理，再到使用 Markdown 编写结构化文档的完整闭环。最后，通过配置 SSH 免密登录，你将体验到更高效、更安全的开发工作流。
|
||
|
||
---
|
||
|
||
## 任务1：Git/Gitee/Github的使用 (45分钟)
|
||
|
||
### **目标**
|
||
掌握基本的 Git 命令行操作，理解分布式版本控制的核心概念，并能在 Gitee 平台上创建、克隆、推送和管理代码仓库。
|
||
|
||
### **步骤**
|
||
|
||
#### **步骤 1：在 Windows 中安装 Git**
|
||
|
||
1. **访问官网**：打开浏览器，访问 Git 官方下载页面：[https://git-scm.com/download/win](https://git-scm.com/download/win)。
|
||
2. **下载安装**：页面会自动检测你的系统并提供合适的 64 位或 32 位安装包。点击下载按钮，等待下载完成。
|
||
3. **运行安装**：双击下载好的 `.exe` 文件启动安装向导。
|
||
4. **保持默认**：在安装过程中，所有选项均可保持默认设置，直接点击“Next”直至安装完成。这将安装 Git Bash（一个类 Unix 的命令行终端）、Git GUI 以及核心命令行工具。
|
||
5. **验证安装**：安装完成后，可以在开始菜单中搜索并打开 “Git Bash”。在弹出的黑色窗口中输入 `git --version` 并按回车，如果显示版本号（如 `git version 2.xx.x.windows.1`），则说明安装成功。
|
||
|
||
#### **步骤 2：注册 Gitee 账号**
|
||
|
||
- **访问网站**：打开浏览器，访问 Gitee 官网：[https://gitee.com](https://gitee.com)。
|
||
- **注册账号**：点击页面右上角的“注册”按钮。你可以选择使用手机号、邮箱或第三方账号（如微信、QQ）进行快速注册。按照页面提示填写必要信息，完成账号注册和邮箱验证。
|
||
|
||
#### **步骤 3：在 Gitee 创建一个新的仓库**
|
||
|
||
1. **登录账号**：使用刚注册的账号登录 Gitee。
|
||
2. **新建仓库**：登录后，点击页面右上角的“+”号，然后选择“新建仓库”。
|
||
3. **配置仓库**：
|
||
* **仓库名称**：输入 `test`。
|
||
* **仓库路径**：系统会自动生成，通常为你的用户名/test。
|
||
* **仓库介绍**：可留空或简单填写“Git学习测试仓库”。
|
||
* **仓库可见性**：选择 **私有仓库**（Private），这样只有你自己能看到。
|
||
* **初始化仓库**：
|
||
* 勾选 **添加 .gitignore 文件**，并在下拉菜单中选择 `Java`。这会自动忽略编译生成的 `.class` 文件等。
|
||
* 勾选 **添加 README.md 文件**。这会为你创建一个项目说明文档。
|
||
* **分支模型**：保持默认的“单分支（master）”即可。
|
||
* **项目语言**：选择 **Java**。
|
||
4. **创建仓库**：检查无误后，点击底部绿色的“创建”按钮。
|
||
|
||
#### **步骤 4：克隆远程仓库到本地**
|
||
|
||
1. **打开终端**：在你的电脑上，打开 Git Bash（推荐）或 Windows PowerShell。
|
||
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：在test目录下创建目录和文件**
|
||
|
||
1. **创建目录**：在 Windows 文件资源管理器中，导航到 `D:\javaweb\test` 目录，右键点击空白处，选择“新建” -> “文件夹”，将新文件夹命名为 `tasks`。
|
||
2. **创建文件**：进入 `tasks` 文件夹，右键点击空白处，选择“新建” -> “文本文档”，将文件命名为 `chapter01-tasks.md`。注意，如果系统默认隐藏了文件扩展名，你需要确保文件名是 `chapter01-tasks.md`，而不是 `chapter01-tasks.md.txt`。
|
||
3. **拷贝内容**：用记事本或其他文本编辑器打开你正在阅读的这份指南（即本文件），全选（Ctrl+A）并复制（Ctrl+C）所有内容。然后打开 `chapter01-tasks.md` 文件，粘贴（Ctrl+V）进去并保存。
|
||
|
||
#### **步骤 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：修改 README.md 文件**
|
||
|
||
1. **打开文件**：在文件资源管理器中，找到 `test` 目录下的 `README.md` 文件，用记事本、VS Code 或其他你喜欢的编辑器打开它。
|
||
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的Git基本使用 （20分钟)
|
||
|
||
### **目标**
|
||
熟悉 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” 输入框中输入提交信息，例如：“通过IDEA添加开发环境信息”。
|
||
* 点击 “Commit and Push” 按钮（或先点 “Commit”，再点 “Push”）。
|
||
* 在 “Push Commits” 对话框中，确认要推送到 `origin/master`，然后点击 “Push”。IDEA 会执行推送操作，并在底部的 “Version Control” 工具窗口中显示操作日志。
|
||
7. **关闭项目**：点击 IDEA 菜单栏的 “File” -> “Close Project”。这会关闭当前项目，返回到欢迎界面。
|
||
8. **删除本地文件夹**：打开 Windows 文件资源管理器，找到 `D:\javaweb\test` 文件夹，将其删除。这模拟了项目丢失或需要在新机器上重新获取代码的场景。
|
||
9. **从版本控制克隆项目**：
|
||
* 在 IDEA 欢迎界面，点击 “Get from VCS”（VCS 指 Version Control System）。
|
||
* 在 “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的使用 (20分钟)
|
||
|
||
### **目标**
|
||
熟悉 Markdown 的基本语法规则，能够使用它来编写结构清晰、格式美观的文档，并将其应用于项目中的 `README.md` 和任务文件。
|
||
|
||
### **步骤**
|
||
|
||
1. **继续操作**：确保你已经在 IntelliJ IDEA 中打开了 `test` 项目。
|
||
2. **编辑任务文件**：在 “Project” 面板中，导航到 `tasks/chapter01-tasks.md` 文件并双击打开。此时，文件内容是你之前从本指南拷贝过去的纯文本。
|
||
3. **应用 Markdown 语法**：现在，你需要将这份纯文本“美化”成标准的 Markdown 格式。例如：
|
||
* 将 `# 第一章. 概述 （90分钟）` 保留，它已经是正确的 Markdown 一级标题。
|
||
* 将 `## 任务1：Git/Gitee/Github的使用 (45分钟)` 保留，它是二级标题。
|
||
* 将 `- **目标**：掌握基本的Git命令和Gitee/Github的使用。` 修改为：
|
||
```markdown
|
||
- **目标**：掌握基本的 Git 命令和 Gitee/Github 的使用。
|
||
```
|
||
（这里主要是调整了空格，使其更规范）
|
||
* 将 `### **步骤 1：在 Windows 中安装 Git**` 修改为：
|
||
```markdown
|
||
### 步骤 1：在 Windows 中安装 Git
|
||
```
|
||
（去掉 `**`，因为 `###` 本身已经是标题，加粗是多余的）
|
||
* 将编号列表 `1. 访问 Git 官网...` 保留，Markdown 会自动识别。
|
||
* 将代码块用 \`\`\`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” 窗口中，勾选这两个文件。
|
||
* 在提交信息中输入：“格式化任务文件并丰富README”。
|
||
* 点击 “Commit and Push”，将你的 Markdown 学习成果推送到远程仓库。
|
||
|
||
---
|
||
|
||
## 增强任务4： 设置ssh方式免密访问gitee仓库
|
||
|
||
### **目标**
|
||
配置 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`）。
|
||
* **设置密码短语（Passphrase）**：接下来会提示 `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` 开始，到你的邮箱结束），然后复制（Ctrl+C）。
|
||
|
||
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 开发打下了坚实的工具基础。 |