作业一：Git 与 Gitea 使用入门

课程信息

• 课程名称: 人工智能数据服务
• 班级: 人工智能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」选项，说明安装成功！

---

五、配置 Git（只需做一次）

第一步：打开 Git Bash

在桌面空白处 右键 → 点击「Git Bash Here」

会弹出一个黑色的命令行窗口，这就是 Git Bash。

第二步：设置你的信息

在 Git Bash 窗口中，逐行输入以下命令（把学号换成你自己的）：

git config --global user.name "你的学号"

按回车，然后输入：

git config --global user.email "你的学号@student.edu.cn"

按回车。

示例（假设学号是 2509165001）：

git config --global user.name "2509165001"

git config --global user.email "2509165001@student.edu.cn"

第三步：设置记住密码

输入以下命令，这样以后不用每次都输入密码：

git config --global credential.helper store

💡 提示：这些命令不会有任何输出，没有报错就是成功了。

---

六、下载（克隆）你的作业仓库

第一步：创建作业文件夹

1. 打开「此电脑」或「文件资源管理器」
2. 进入 D盘（或你想存放作业的位置）
3. 右键 → 新建 → 文件夹
4. 把文件夹命名为 课程作业

第二步：在文件夹中打开 Git Bash

1. 双击进入刚才创建的 课程作业 文件夹
2. 在文件夹空白处 右键
3. 点击「Git Bash Here」

第三步：克隆仓库

在 Git Bash 中输入以下命令（把"你的学号"换成你的实际学号）：

git clone http://118.190.153.85:3003/你的学号/homework.git

示例（假设学号是 2509165001）：

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. 输入以下代码（把学号和姓名换成你自己的）：

# 人工智能数据服务 - 作业一
# 学号：你的学号
# 姓名：你的姓名

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」

第二步：查看修改状态

输入：

git status

你会看到红色的文字显示 homework01/，表示有新增的文件。

第三步：添加文件到暂存区

输入：

git add .

💡 注意：add 后面有一个空格和一个英文句号 .，表示添加所有文件。

第四步：提交修改

输入：

git commit -m "完成作业一：Git入门"

💡 引号里面是提交说明，可以写你这次做了什么。

第五步：推送到服务器

输入：

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 文件，恭喜你，作业提交成功！🎉

---

十、以后提交作业的流程（简化版）

学会之后，每次提交作业只需要这几步：

# 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班 - 人工智能数据服务课程