一、速览：这是一个什么样的网站

入门

浙江大学课程攻略共享计划仓库页面

先说它解决什么痛点：一门课的历年卷子、前人整理的复习提纲、教材电子版，往往散落在各个 QQ 群、论坛帖子里，靠学长口口相传，找到全凭运气。这个项目把这些资料集中到一个公开、可长期访问的地方，按课程分门别类放好。

它目前收录的内容包括：选课攻略、电子版教材、平时作业答案、历年试卷、复习资料、开卷考试用的 A4 纸，计算机学院的大部分专业课都覆盖到了。

资料仅供参考，请自己判断其适用性。这是项目方原话，也是使用它的正确心态：把它当参考书，不要当标准答案。

整个项目托管在 GitHub（一个程序员用来存代码和文档的公共仓库网站）上，所以你需要先理解一个基本概念：仓库就像一个共享网盘，文件夹按课程划分，每个文件夹里通常有一份说明文档告诉你里面有什么。

二、入门：怎么找到你要的资料

入门

最直接的入口是项目官网，它会把仓库内容渲染成带目录的网页，看起来比 GitHub 原始界面友好得多：

https://qsctech.github.io/zju-icicles/

打开后从左侧或首页的目录树进入课程文件夹，里面列出的每个文件都可以直接点开查看或下载。如果这门课目录里有 README，先读它，前人一般会在里面写清楚每个文件是什么、哪年的卷子。

如果你想找的课程不在目录里，用 GitHub 自带的搜索更快。在仓库页面按 / 或点顶部搜索框，输入课程名、老师拼音首字母、课号都可以。搜索时可以用引号锁定精确词，例如搜 "A4" 找开卷资料，搜具体教材名找电子书。

仓库地址：https://github.com/QSCTech/zju-icicles
搜索语法示例："编译原理" 或 "CS214"

一个实用习惯：先看文件名里的年份。试卷类资料年份越新，参考价值通常越高，但也要注意课程改版后旧卷的题型可能已经对不上。

找不到时别急着放弃，有两个兜底路径：一是去项目的 Issue 列表里搜搜看有没有人问过同样的问题；二是直接新开一个 Issue 提问，维护者和其他同学会看到。

三、进阶：把自己手里的资料投出去

进阶 · 推荐细读

项目方把贡献的重要性强调了三遍，投稿是它能持续存在的唯一原因。投稿有两条路，难度差别很大，建议零基础先走第二条。

路线一：提交 Pull Request（PR，即请求把你改动的内容合并进主仓库）

流程是先 Fork（把整个仓库复制一份到你自己的 GitHub 账号下），再往自己的副本里传文件，最后发起 PR。README 特别推荐用 GitHub 网页端上传，因为仓库体积很大，克隆到本地并不轻松。

在网页端传文件的具体做法：

  1. 打开你想放文件的文件夹，点绿色 Download 按钮旁边的 upload 链接。
  2. 把浏览器地址栏中最后一段文件夹名改成你新建的文件夹名，回车，再上传文件——这样就能凭空新建一个目录。
  3. 上传完成后，回到你 Fork 出的仓库首页，点 "Contribute" / "New pull request" 提交 PR。

路线二：把资料附在 Issue 里

不想折腾 Fork 和 PR 的话，直接新开一个 Issue，把资料作为附件拖进去，说明是哪门课、什么类型，维护者会代为归档。对新手来说这条路更省事，效果一样。

提交前请先看一眼仓库的文件组织方式，资料放错目录会增加维护者的整理负担。同理，上传前建议先打开该课程文件夹，看看是否已有同名资料，避免重复。

关于老师的信息有条硬规矩：评价教师一律用姓名拼音首字母缩写，不要写全名；老师自己提供的课件不要上传，因为每年可能都会更新。

四、踩坑：PR 掉队了怎么办，以及不能上传什么

进阶 · 推荐细读

坑一：Fork 出来的仓库和主仓库差了几百个提交

提交 PR 时你可能注意到自己的 Fork 和主分支有几十甚至上百个不同的 commit（提交记录）。原因很简单：主仓库一直在被人更新，而你的副本是某个时间点的快照。

处理办法分两种情况：不熟悉 git（一个管理文件版本的工具）的人，建议备份好自己上传的文件后，直接删掉 Fork，重新 Fork、重新上传、重新提交 PR，最省心；熟悉 git 原理的人，可以在自己的副本上做 rebase（把你的改动重新接到最新版本上）来消除历史冲突。

坑二：传了不该传的东西

以下内容不适合上传，这是项目明确划出的红线：

  • 盗版电子书、付费电子书
  • 盗版或破解版付费软件的安装包
  • 老师课程主页上已经列出的内容（除非先获得老师许可）

如果你觉得缺了这些资料不完整，更好的做法是写一个 README，放上校内资源平台的链接或获取指引。这条边界不只是合规问题，也决定了仓库能存活多久。

坑三：忽略许可协议

贡献者撰写部分采用 CC-BY-NC-SA 4.0（署名-非商业性使用-相同方式共享）许可，意思是：可以自由复制和修改，但必须署名、不能拿去卖钱、改完也要用同样的协议分享。想把资料转到别处或做成自己的合集时，请先确认符合这三条。

如果你认为仓库中某些文件侵犯了你的权益，项目提供了专用邮箱 tech@zjuqsc.com 用于要求移除。

五、判断建议：什么时候该用它，什么时候不该

深入 · 老手可选

适合用的场景：开学前想摸清某门课的考核方式和老师风格；考前急需历年卷子练手；想找某本教材的电子版先翻翻再决定买不买；想了解某门选修课的实际工作量。

不适合依赖的场景：课程大纲已改版时，旧卷的题型分布可能失效；需要官方权威答案时，作业答案部分由社区贡献，质量参差，建议自己先做完再对照；涉及盗版书籍或付费软件时，请走正规渠道。

关于是否贡献：如果你只是下载资料，什么账号都不需要，打开网页就行。如果你手里有前人留下的卷子、笔记或攻略，建议顺手投一次——哪怕是走 Issue 附件这条路，五分钟的事，却是这个项目能一年年积累下去的全部动力。

想更进一步的读者：可以去 Issue 列表看已有的资料征集帖，那里常写着当前最缺哪些课程的资料；也可以关注自己的课程文件夹，发现文件缺失或内容有误时提纠错 PR，这类改动比上传新资料更容易被合并。

项目信息

项目 值
仓库 QSCTech/zju-icicles
语言 HTML
Star 41,237
Fork 9,589
主页 https://qsctech.github.io/zju-icicles/

参考链接

延伸阅读

想继续探索？这些同领域的教程可能也适合你：