student_repo_049:基于 Git 的学生代码管理项目

用户可通过该项目学习 Git 开发管理流程,完成课程练习与实验。项目提供仓库创建、代码提交、目录结构规范等核心功能,支持练习与实验代码分类管理,便于老师查看与批改。【此简介由AI生成】

Branch1Tags0
FilesLast commitLast update
10 months ago
9 months ago
9 months ago
10 months ago
11 months ago
1 year ago
1 year ago
11 months ago
9 months ago

如何开始 Git 开发管理

hello

准备

Fork 模板仓库

  1. 在 gitcode 注册一个账号,保管好自己的用户名和密码,后续操作会用到
  2. 打开 gitcode 网站的 student_repo_template 仓库,将该模板仓库 Fork 到自己的账号下。具体方法为找到 Fork 按钮,点击 Fork,Fork 后的名字改为 student_repo_xxx ( xxx 是你的短学号,3位数字 )。其它默认即可。最后点击创建Fork项目。之后这样你就拥有了一个和模板仓库相同的版本,自己可以修改和上传。注意名字要改成了短学号,便于老师区分。
  3. 记下自己的Fork 仓库的地址,例如 https://gitcode.com/newthread/student_repo_101.git,后面会用到。(其中 newthread 是你自己的用户名, 另外 repo 名字的最后3位不同)

仓库可见性说明

推荐设置为公开仓库:

  • 老师可以直接访问和查看代码,便于批改作业
  • 无需额外操作,提交后老师即可看到

如果坚持设置为私有仓库:

  • 需要将老师添加为仓库成员才能查看
  • 在仓库设置中找到"成员管理"或"Collaborators"
  • 添加老师的 Gitcode 用户名并授予相应权限
  • 每次提交作业后需要通知老师查看(老师会自己定期查看)

建议使用公开仓库以简化操作流程。

克隆仓库到本地

在本地文件夹中选一个合适的目录,创建本门课程要用到的仓库。该目录会持续使用,所以想个好找的路径。例如 D:\gitcode\。接着在该目录下打开命令行,输入以下命令:

git clone https://gitcode.com/newthread/student_repo_101.git

其中 https://gitcode.com/newthread/student_repo_101.git 是你刚刚 Fork 的仓库地址,请替换成你自己的。为了避免输入出错,这个地址可以直接从网站上仓库的网站上复制。

运行完上面的命令后,会在当前目录下生成一个 student_repo_101 文件夹,里面有一个 README.md 文件,里面是模板仓库的内容。

D:\gitcode\student_repo_101\

以后,这个目录就是你的工作目录,你就可以在本地修改并运行代码了。

此时你可以做一个练习(必做),就是在仓库根目录中找到 student_info.json 中,填入你的姓名,3位数的短学号(short_id),以及你的学号(full_id)。注意,不要破坏 json 文件的格式。

# student_info.json
{
  "name": "张三",
  "short_id": "0",
  "full_id": "001"
}

提交你的修改

接着在命令行中输入以下命令:

git add .
git commit -m "Initial commit"

你刚才对 student_info.json 文件所做的修改就被记录了一次快照(拍了一张照片,需要时可以返回该版本)。

配置 Git 并上传到 Gitcode

在你的本地仓库中打开命令行中输入以下命令:

git config --global user.name "Your Name"
git config --global user.email "youremail@domain.com"

其中 "Your Name" 和 "youremail@domain.com" 分别替换成你的名字和邮箱。

输入 git push origin main,将你的修改推送到 Gitcode 仓库中。此时需要输入用户名和密码。

认证方式说明:

  • 如果使用 HTTPS 方式,需要输入 Gitcode 账号的用户名和密码
  • 推荐使用访问令牌(Access Token)代替密码,更安全
  • 可以在 Gitcode 个人设置中生成访问令牌,复制后作为密码输入

如果遇到认证问题,可以使用 deepseek 等 AI 工具协助解决具体的技术细节。

如果一切顺利,你就可以在线上的 Gitcode 仓库中看到你的修改了。特别是你提交的 student_info.json 文件,里面应该有你填写的姓名,短学号和学号。

登记你的仓库信息

如果上面的步骤作部完成,则在学习群里的「git 仓库登记表」中添加一行内容,内容为:

short_id, full_id, 姓名, 仓库地址url

例如:

101, 202512345678, 张三, https://gitcode.com/newthread/student_repo_101.git

保存并提交修改,这样老师就可以通过这个链接找到你的仓库了。

更方便地使用 Git 工具

记住最重要的4个命令

git status
git add .
git commit -m "message"
git push origin main

如果你觉得命令行实在难以习惯,则强烈建议在Vscode 中使用 git 插件,或通过 github desktop 软件来使用 git。

目录结构约定

在 labs 和 exercises 目录中创建你的练习和实验代码,按照要求提交到 Gitcode 仓库中。必须完全按照已有的模板文件夹结构填写代码文件和保存实验结果。请保持下面的目录结构:

student_repo_101
├── exercises
│   └── exercise_01
│       ├── info.json
│       ├── problem_01
│       │   ├── notes.md
│       │   └── solution.py
│       ├── problem_02
│       │   ├── notes.md
│       │   └── solution.py
│       ├── problem_03
│       │   ├── notes.md
│       │   └── solution.py
│       └── README.md
├── labs
│   └── lab01
│       ├── info.json
│       ├── README.md
│       ├── step_01
│       │   ├── analysis.md
│       │   ├── code.py
│       │   └── output.txt
│       ├── step_02
│       │   ├── analysis.md
│       │   ├── code.py
│       │   └── output.txt
│       └── step_03
│           ├── analysis.md
│           ├── code.py
│           └── output.txt
├── notes
├── radiosim
│   └── README.md
├── README.md
├── scripts
├── student_info.json
└── student_info.md
  • radiosim/ 目录将用来跟踪老师创建的共享库文件,不要对此文件夹内部部的文件做任何修改;
  • exercises/ 目录是上课写代码的地方(按要求修改,保持结构);
  • labs/ 目录是存放实验代码的地方(按要求修改,保持结构);
  • scripts/ 是存储个人代码的地方,可以自然使用(自由使用);
  • notes/ 目录是放笔记文档的地方(自由使用)。

注意:

  • 在模板中 exercises/ 目录 和 labs/ 目录中的子目录数量可能不够用,此时需要增加更多的并行子目录时,按已有的子目录结构创建即可。

  • radiosim/ 目录中的内容将用 submodule 来管理

Introduction

用户可通过该项目学习 Git 开发管理流程,完成课程练习与实验。项目提供仓库创建、代码提交、目录结构规范等核心功能,支持练习与实验代码分类管理,便于老师查看与批改。【此简介由AI生成】

Customize your domain