test1/README.md

第一章. 概述 （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。
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。
• 注册账号：点击页面右上角的“注册”按钮。你可以选择使用手机号、邮箱或第三方账号（如微信、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 目录下，先确保该目录存在。然后执行以下命令进入该目录：

   cd /d/javaweb
   # 或者在 PowerShell 中: cd D:\javaweb
   

3. 执行克隆：在 Gitee 的仓库页面，找到“克隆/下载”按钮，复制 HTTPS 地址（形如 https://gitee.com/你的用户名/test.git）。在终端中输入以下命令进行克隆：

   git clone https://gitee.com/你的用户名/test.git
   

   请务必将 你的用户名 替换为你在 Gitee 注册的实际用户名。
4. 进入项目：克隆完成后，会生成一个名为 test 的文件夹。使用 cd 命令进入该目录：

   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 目录下），执行以下命令，将所有新增和修改的文件添加到暂存区：

   git add .
   

2. 提交到本地仓库：执行提交命令，为这次改动添加一条描述信息：

   git commit -m "添加 chapter01-tasks.md 文件"
   

3. 推送到远程仓库：将本地的提交推送到 Gitee 的 master 分支：

   git push origin master
   

   首次推送时，系统可能会弹出一个窗口要求你输入 Gitee 的用户名和密码（或个人访问令牌）。
4. 验证推送：刷新你的 Gitee 仓库网页，你应该能看到新创建的 tasks 目录和里面的 chapter01-tasks.md 文件。

步骤 7：修改 README.md 文件

1. 打开文件：在文件资源管理器中，找到 test 目录下的 README.md 文件，用记事本、VS Code 或其他你喜欢的编辑器打开它。
2. 编辑内容：在文件末尾或开头添加一些内容，例如：

   # 项目简介
   
   这是一个用于练习 Git 的 Java 项目。
   
   ## 学习目标
   - 掌握 Git 基础命令
   - 熟悉 Gitee 平台操作
   

步骤 8：提交并推送修改

1. 添加修改：回到终端，执行 git add 命令，专门添加修改过的 README.md 文件：

   git add README.md
   

2. 提交修改：提交这次修改：

   git commit -m "更新 README.md，添加项目简介和学习目标"
   

3. 推送修改：再次推送到远程仓库：

   git push origin master
   

   这次推送应该不会再要求输入密码（如果系统记住了你的凭据）。

步骤 9：查看提交记录

在终端中，输入以下命令查看你的提交历史：

git log

你会看到一个列表，显示了你所有的提交记录，包括提交的哈希值、作者、日期和提交信息。按 Q 键可以退出日志查看界面。

---

任务2：IntelliJ IDEA的Git基本使用 （20分钟)

目标

熟悉 IntelliJ IDEA 的安装与基本配置，并掌握如何在 IDE 的图形化界面中进行 Git 操作，如提交、推送、克隆等，提升开发效率。

步骤

1. 下载 IDEA：访问 JetBrains 官网的 IntelliJ IDEA 下载页面：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 文件。在编辑器中，继续为其添加一些内容，例如：

   ## 开发环境
   - 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的使用。 修改为：

     - **目标**：掌握基本的 Git 命令和 Gitee/Github 的使用。
     

     （这里主要是调整了空格，使其更规范）
   • 将 ### **步骤 1：在 Windows 中安装 Git** 修改为：

     ### 步骤 1：在 Windows 中安装 Git
     

     （去掉 **，因为 ### 本身已经是标题，加粗是多余的）
   • 将编号列表 1. 访问 Git 官网... 保留，Markdown 会自动识别。
   • 将代码块用 ```bash 和 ``` 包裹起来。
   • 你可以根据自己的理解，为文档添加更多层级的标题、列表、加粗、斜体等。
4. 编辑 README.md：打开项目根目录的 README.md 文件，使用 Markdown 语法为其添加更丰富的内容。例如，可以添加一个表格来列出项目成员，或添加一个链接指向 Gitee 官网。

   [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（以管理员身份运行不是必须的，但有时能避免权限问题）。
   • 输入以下命令并按回车：

     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，输入以下命令测试连接：

     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 中执行克隆：

     cd /d/javaweb
     git clone git@gitee.com:你的用户名/test.git
     

   • 之后，所有在 test 仓库目录下的 git pull, git push 等操作都将通过 SSH 进行，实现免密访问。

恭喜你！至此，你已经完成了第一章的所有任务，为后续的 Java Web 开发打下了坚实的工具基础。