学生可通过该项目进行代码练习、实验管理及版本控制,规范提交作业。核心功能包括 Git 操作指南、固定目录结构、学生信息配置,支持练习与实验代码分类存储及老师查看。【此简介由AI生成】
| Files | Last commit | Last update |
|---|---|---|
| 10 months ago | ||
| 9 months ago | ||
| 10 months ago | ||
| 10 months ago | ||
| 10 months ago | ||
| 10 months ago | ||
| 9 months ago | ||
| 10 months ago | ||
| 1 year ago | ||
| 1 year ago | ||
| 1 year ago | ||
| 11 months ago |
如何开始 Git 开发管理
准备
Fork 模板仓库
- 在 gitcode 注册一个账号,保管好自己的用户名和密码,后续操作会用到
- 打开 gitcode 网站的 student_repo_template 仓库,将该模板仓库 Fork 到自己的账号下。具体方法为找到 Fork 按钮,点击 Fork,Fork 后的名字改为
student_repo_xxx(xxx是你的短学号,3位数字 )。其它默认即可。最后点击创建Fork项目。之后这样你就拥有了一个和模板仓库相同的版本,自己可以修改和上传。注意名字要改成了短学号,便于老师区分。 - 记下自己的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