From d2bb79bb861bf2693b5f09877ff21f6e92cf392e Mon Sep 17 00:00:00 2001 From: Teacher Date: Fri, 2 Jan 2026 19:45:54 +0800 Subject: [PATCH] =?UTF-8?q?=E5=8F=91=E5=B8=83=E4=BD=9C=E4=B8=9A:=20README.?= =?UTF-8?q?md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 378 +++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 376 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 56baae1..ee1a7ea 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,377 @@ -# homework +# 作业一：Git 与 Gitea 使用入门 -人工智能数据服务 - 作业仓库 \ No newline at end of file +## 课程信息 +- **课程名称**: 人工智能数据服务 +- **班级**: 人工智能251班 + +--- + +## 一、作业目标 + +学会使用 Git 和 Gitea 平台提交作业。本学期的作业都将通过这个平台提交。 + +--- + +## 二、什么是 Git 和 Gitea？ + +- **Git**: 一个代码版本管理工具，可以记录你代码的每一次修改，就像游戏存档一样 +- **Gitea**: 一个网站平台，用来存放和管理你的代码，老师可以在上面查看你的作业 + +简单理解：**Git 是工具，Gitea 是网站**。你用 Git 工具把作业上传到 Gitea 网站。 + +--- + +## 三、登录 Gitea 平台 + +### 第一步：打开网站 + +在浏览器地址栏输入： +``` +http://118.190.153.85:3003/ +``` + +### 第二步：登录账号 + +点击右上角「登录」按钮： + +- **用户名**: 你的学号（例如 `2509165001`） +- **密码**: 学号后6位（例如 `165001`） + +### 第三步：修改密码 + +首次登录会要求你修改密码，请设置一个自己能记住的新密码。 + +> ⚠️ **重要**：请牢记你的新密码！忘记密码请联系老师重置。 + +### 第四步：查看你的作业仓库 + +登录后，点击右上角头像 → 「个人资料」，可以看到你的仓库列表。 + +或者直接访问（把"你的学号"换成你的实际学号）： +``` +http://118.190.153.85:3003/你的学号/homework +``` + +--- + +## 四、安装 Git（Windows 系统） + +### 第一步：下载 Git + +打开浏览器，访问： +``` +https://git-scm.com/download/win +``` + +页面会自动开始下载，如果没有，点击「Click here to download manually」。 + +### 第二步：安装 Git + +1. 双击下载好的安装包（文件名类似 `Git-2.xx.x-64-bit.exe`） +2. 如果弹出安全提示，点击「是」或「运行」 +3. **安装过程中所有选项都保持默认，一直点「Next」** +4. 最后点击「Install」开始安装 +5. 安装完成后点击「Finish」 + +### 第三步：验证安装成功 + +1. 在桌面或任意文件夹内，**右键点击空白处** +2. 如果看到菜单中有「**Git Bash Here**」或「**Open Git Bash here**」选项，说明安装成功！ + +![右键菜单示意](https://git-scm.com/images/logo@2x.png) + +--- + +## 五、配置 Git（只需做一次） + +### 第一步：打开 Git Bash + +在桌面空白处 **右键** → 点击「**Git Bash Here**」 + +会弹出一个黑色的命令行窗口，这就是 Git Bash。 + +### 第二步：设置你的信息 + +在 Git Bash 窗口中，**逐行输入**以下命令（把学号换成你自己的）： + +```bash +git config --global user.name "你的学号" +``` +按回车，然后输入： +```bash +git config --global user.email "你的学号@student.edu.cn" +``` +按回车。 + +**示例**（假设学号是 2509165001）： +```bash +git config --global user.name "2509165001" +``` +```bash +git config --global user.email "2509165001@student.edu.cn" +``` + +### 第三步：设置记住密码 + +输入以下命令，这样以后不用每次都输入密码： +```bash +git config --global credential.helper store +``` + +> 💡 **提示**：这些命令不会有任何输出，没有报错就是成功了。 + +--- + +## 六、下载（克隆）你的作业仓库 + +### 第一步：创建作业文件夹 + +1. 打开「此电脑」或「文件资源管理器」 +2. 进入 **D盘**（或你想存放作业的位置） +3. **右键** → 新建 → 文件夹 +4. 把文件夹命名为 `课程作业` + +### 第二步：在文件夹中打开 Git Bash + +1. 双击进入刚才创建的 `课程作业` 文件夹 +2. 在文件夹空白处 **右键** +3. 点击「**Git Bash Here**」 + +### 第三步：克隆仓库 + +在 Git Bash 中输入以下命令（**把"你的学号"换成你的实际学号**）： + +```bash +git clone http://118.190.153.85:3003/你的学号/homework.git +``` + +**示例**（假设学号是 2509165001）： +```bash +git clone http://118.190.153.85:3003/2509165001/homework.git +``` + +按回车后： +- 会提示输入用户名：输入你的**学号**，按回车 +- 会提示输入密码：输入你的 **Gitea 密码**（就是登录网站的密码），按回车 + +> ⚠️ **注意**：输入密码时屏幕上不会显示任何字符，这是正常的，直接输入完按回车即可。 + +### 第四步：验证克隆成功 + +克隆完成后，你会看到 `课程作业` 文件夹里多了一个 `homework` 文件夹，这就是你的作业仓库。 + +``` +D:\课程作业\ +└── homework\ ← 这就是你的作业仓库 + └── README.md ← 本说明文件 +``` + +--- + +## 七、完成第一次作业 + +### 第一步：进入作业仓库文件夹 + +双击进入 `homework` 文件夹。 + +### 第二步：创建作业文件夹 + +1. 在 `homework` 文件夹内，**右键** → 新建 → 文件夹 +2. 命名为 `homework01` + +### 第三步：创建 Python 文件 + +1. 双击进入 `homework01` 文件夹 +2. **右键** → 新建 → 文本文档 +3. 把文件名改成 `hello.py`（**注意要把 .txt 也删掉**） +4. 如果弹出警告说"可能导致文件不可用"，点击「是」 + +> 💡 **看不到文件扩展名？** +> +> 打开任意文件夹 → 点击顶部「查看」→ 勾选「文件扩展名」 + +### 第四步：编写代码 + +1. 右键 `hello.py` → 选择「用记事本打开」或用你熟悉的代码编辑器打开 +2. 输入以下代码（**把学号和姓名换成你自己的**）： + +```python +# 人工智能数据服务 - 作业一 +# 学号：你的学号 +# 姓名：你的姓名 + +print("=" * 40) +print("学号：你的学号") +print("姓名：你的姓名") +print("Hello, Git!") +print("我已经学会使用 Git 提交作业啦！") +print("=" * 40) +``` + +3. 保存文件（Ctrl + S） + +### 第五步：检查文件结构 + +现在你的文件夹结构应该是这样的： + +``` +D:\课程作业\ +└── homework\ + ├── README.md + └── homework01\ + └── hello.py +``` + +--- + +## 八、提交作业到 Gitea + +### 第一步：在作业仓库中打开 Git Bash + +1. 回到 `homework` 文件夹（**不是** homework01） +2. 在空白处 **右键** → 「**Git Bash Here**」 + +### 第二步：查看修改状态 + +输入： +```bash +git status +``` + +你会看到红色的文字显示 `homework01/`，表示有新增的文件。 + +### 第三步：添加文件到暂存区 + +输入： +```bash +git add . +``` + +> 💡 **注意**：`add` 后面有一个空格和一个英文句号 `.`，表示添加所有文件。 + +### 第四步：提交修改 + +输入： +```bash +git commit -m "完成作业一：Git入门" +``` + +> 💡 引号里面是提交说明，可以写你这次做了什么。 + +### 第五步：推送到服务器 + +输入： +```bash +git push +``` + +如果提示输入用户名密码，输入你的学号和 Gitea 密码。 + +看到类似以下内容说明成功： +``` +To http://118.190.153.85:3003/你的学号/homework.git + xxxxxxx..xxxxxxx main -> main +``` + +--- + +## 九、验证作业提交成功 + +打开浏览器，访问你的仓库： +``` +http://118.190.153.85:3003/你的学号/homework +``` + +如果能看到 `homework01` 文件夹和里面的 `hello.py` 文件，恭喜你，作业提交成功！🎉 + +--- + +## 十、以后提交作业的流程（简化版） + +学会之后，每次提交作业只需要这几步： + +```bash +# 1. 在 homework 文件夹中打开 Git Bash + +# 2. 添加修改 +git add . + +# 3. 提交（引号里写本次作业内容） +git commit -m "完成作业X" + +# 4. 推送 +git push +``` + +--- + +## 十一、常见问题 + +### Q1: 克隆时提示 "repository not found" +检查命令中的学号是否正确。 + +### Q2: push 时提示 "failed to push" +可能是网络问题，稍等一会再试，或者检查网络连接。 + +### Q3: 提示 "Please tell me who you are" +说明没有配置 Git，回到「第五节：配置 Git」重新操作。 + +### Q4: 输入密码时看不到任何字符 +这是正常的！直接输入密码按回车即可，系统为了安全不显示密码。 + +### Q5: 提示 "fatal: not a git repository" +说明你不在 `homework` 文件夹内，请确保在正确的文件夹中打开 Git Bash。 + +### Q6: 忘记 Gitea 密码了 +联系老师重置密码。 + +### Q7: 文件扩展名 .txt 删不掉 +参考「第七步-第三步」的提示，先在文件夹设置中显示文件扩展名。 + +--- + +## 十二、Git 命令速查表 + +| 命令 | 作用 | 示例 | +|------|------|------| +| `git clone 地址` | 下载仓库 | `git clone http://...` | +| `git status` | 查看状态 | `git status` | +| `git add .` | 添加所有修改 | `git add .` | +| `git commit -m "说明"` | 提交修改 | `git commit -m "完成作业"` | +| `git push` | 推送到服务器 | `git push` | +| `git pull` | 从服务器拉取更新 | `git pull` | + +--- + +## 十三、截止时间 + +**202X年X月X日 23:59:59** + +每次提交作业时请在截止时间前完成推送，系统会记录你的提交时间。 + +--- + +## 十四、评分标准（参考） + +| 项目 | 分值 | +|-----|------| +| 正确创建 `homework01` 文件夹 | 20分 | +| 正确创建 `hello.py` 文件 | 20分 | +| 代码内容符合要求 | 30分 | +| 成功推送到 Gitea | 20分 | +| 按时提交 | 10分 | + +--- + +## 十五、遇到问题怎么办？ + +1. 仔细阅读本文档，按步骤操作 +2. 参考「常见问题」部分 +3. 网上搜索错误信息 +4. 课上或课后联系老师 + +--- + +祝学习顺利！🚀 + +*人工智能251班 - 人工智能数据服务课程*