前言
约 2807 字大约 9 分钟
2025-02-19
Site Total Visitors Loading
您好,亲爱的朋友。这是一本和计算机、项目建设、开放公共服务、大学生活等相关的手册,由一些老师、同学以及朋友共同编写,也是我们对整个大学生涯的一个纪念。
这同时也是一份献给重医学弟学妹们的礼物。如果这本书能对你们的本科生涯有哪怕一丝一毫的帮助,都是对我们极大的鼓励和慰藉。
如果你觉得我们写得还不错,请在 Github 上给我们点一个大大的star,这是对我们最大的鼓励。
为什么写这本书
在查找各种资料的时候,尤其是计算机类的,我时常会因为资源获取的麻烦(要么是百度网盘,要么是微信关注公众号)、CSDN 等平台的收费、文档的时效性等等问题而感到苦恼,而我在这种苦恼中度过了课程最多的大一。
这一切的转机发生在发生在大二的时候,我无意中看到了 CS-DIY 这本书,当时的内容已经相当丰富,基本覆盖了计科、智能系、软工系的绝大多数课程。起初,我抱着怀疑的态度阅读了其中比较简单的一篇 - CS61A ,哇,那时候我才感受到原来 Python 或者说编程可以这么简单而有趣。
大二这一年,我参加了许多比赛,也收获了一些奖项。但一种无名的空虚感侵蚀着我,望着一张张冰冷的“奖状”,我不禁反思:这是我想要的大学生活吗?这些对我真的有帮助吗?
的确,名义上这些代表我,或者说我的团队在过去做出的努力,在各种面试中也起到了一定作用。但我也清楚地知道,这些身外之物说明不了什么,想要真正成长,我需要实际的、系统性的解决问题的能力,并且将这些如 CSDIY 一样无偿地分享给其他人。
于是,在大三上,我整理了所有参加过的比赛、学习过的知识,将其放入了语雀文档站里。最初,我找到了几位熟悉的老师交流了下想法,他们都十分支持这种做法。有一位老师非常担心写这个会占用我们的时间,认为对我们成长没太大用处,表示在现在这个信息十分容易获取的时代意义不大,发了长达 200 秒的语音劝我们慎重考虑。
但我内心十分清楚计算机类学科的特殊性,正是因为信息爆炸,现在获取到所需要的资料变得更为困难,尤其是生成式人工智能盛行的今天,对于稍微困难点的问题,我们需要花费更多时间来鉴别资料的时效性、可用性、真实性等,很多无意义的时间便浪费在了上面。再者,我们十分需要一个交流的平台,来减少信息的极度不对等性。
在更多地与同学、老师、朋友们交流后,我决定开始建设项导文档站,现在项导文档包含的内容已相对丰富。当然,作为一个还未毕业的本科生,我深感自己没有能力也没有权利去宣扬这种方式,古人荀子《劝学》中所述说明有人积极的同时也有人消极,我只是希望这份资料能让那些同样有自学之心和毅力朋友可以少走些弯路,收获更丰富、更多样、更满足的学习体验。
这本书适合谁
这本书适合所有对计算机、项目建设、开放公共服务、大学生活等感兴趣的朋友,尤其是医科大学的同学们。我们希望通过这本书,能够帮助大家更好地了解计算机领域的知识和技能,减少计算机学习成本,同时也为大家提供一个交流和学习的平台。
关于为什么自行开发与维护
语雀的缺陷
项导文档之前在语雀也有存档,随着用户体量的增大,也暴露出一些问题:
- 内容审核严格:语雀会对发布到互联网的团队文档进行严格审核,一旦检测到敏感词就会风控,极为不便;
- 自定义程度低:不支持图标、 markdown 拓展等,组件库几乎等于没有;
- 域名不可自定义:对 SEO 不友好,而且文档永久链接是 Nano 加密的字符组(像
ag1xgaxa这样),不直观; - 需要注册和邀请:语雀需要每一位成员都进行注册和管理员审核协作,对于双方都不方便;
- 太过简单:不需要开发,对于 markdown 协作和前端开发未必是好事;
- 不可控风险:语雀曾在 宕机后长时间后才恢复 的过往,虽然可能并非故意为之,但确实会影响到文档的维护和企业形象。
你也想加入到贡献者的行列
一个人的力量终究是有限的,项导文档欢迎各位加入建设,目前我们针对同学们的情况编写了部分文档,涵盖的内容可能不齐全或存在可优化之处。如果有大佬想在其他领域分享自己的自学经历与资源,或有项目想要分享的,欢迎加入文档建设。请参考 贡献指南 或也欢迎 和我电子邮件 联系。
关于我们
_ 项导文档,人人为我,我为人人。不必在意我们的名字,因为你就是下一个故事。_
PGuide Docs: Each exists for all, and all for each. Our names are but fleeting echoes, for within you lies the seed of the next tale.
贡献者名单
所有贡献者名单:
名字的由来
工作室名为 PGuide Studio ,中文为 项导工作室。P 代表 Project ,Guide 代表引导或指南。我们希望能为大家提供一个编程类项目学习的指南,将这些项目代代相传。
怎么在评论区互动
- 转到 登录界面
- 使用 Markdown 格式提问
- 邮件收到回复
一起学习
项导文档的设计思想是通过新同学的阅读中产生的疑惑来完善文档,将所学知识应用到真实的开发场景中。我们虽然名义上是医科大的同学,但同样对计算机充满好奇与热情。
从现实条件上讲,每个人的精力和经验有限,计算机领域知识相关性强、迭代速度快,文档维护只能尽力而为。如果您对某篇文档有更好的建议,可以参考贡献指南来加入文档的建设。
好在互联网上,不乏有更优秀的前辈们探索的道路与智慧的结晶。如果您也是类似的开源文档、项目开发者,欢迎 [添加友情链接]( /friends/quotes/# 我该怎样添加社会链接),互相交流学习。下面是项导文档中参考和引用的优秀开源项目:
较为完整的目录:
- Ac Wiki
- Linux Do Wiki
- Linux 101
- Linux 201
- 你缺失的那门计算机课
- CSDIY
- 编程导航
- Code RoadMap
- OI Wiki
- CTF Wiki
- Hello CTF
- 电脑开荒网
- Python PEP
- CTF Archive
- CS Books
- Awesome Courses
- Java Guide
- 大学生活指北
以上,对互联网开源精神致敬,对世界的美好致谢。
致谢
自项导文档站开设已来,已累计获得 15 万 + 的阅读量,共有 90+ 位成员参与建设,感谢每一位同学、老师、大佬们的支持与贡献。我们会继续努力,争取在未来的日子里为大家提供更好的服务和文档支持。
里程碑
项导文档语雀站
rand777 在语雀建设第一版项导文档站,邀请了部分同学加入。
2024-05-26
建设里程碑 01
语雀文档站 字数达 10W,共有 21 位成员,此时并未在互联网开放,阅读量达 4000。
2024-11-20
项导文档站开放
项导文档站在互联网公开访问,秉承着人人为我,我为人人的精神,吸引了许多优秀的同学加入建设。
2025-01-22

入选 Plume 选集
通过 PullRequest 入选 Vuepress Plume 主题选集,感谢 Plume 团队的支持与认可。
2025-03-09
建设里程碑 02
项导文档站总字数达 8W,阅读量达 3W+,共计 50+ 位成员参与建设,感谢!
2025-03-11
建设里程碑 03
项导文档站总字数达 12W,阅读量达 4W+!
2025-04-27
建设里程碑 04
项导文档站总字数达 15W,阅读量达 8W,共有 77 位成员、18 个组织加入建设。
2025-05-20
建设里程碑 05
项导文档站总字数达 16W,阅读量达 10W,共有 82 位成员、25 个组织加入建设。
2025-06-11
基础设施建设 01
支持了在线编辑、评论区、搜索、服务器状态查询等多种功能。各种网络优化下大陆地区访问速度大幅提升,国际主站点 平均延迟低于 100ms,国内镜像站点平均延迟 低于 20ms,优化了用户体验。
2025-06-15
获得奖项 02
项导文档获
中国计算机设计大赛 全国三等奖,继续加油!
2025-07-31
建设里程碑 06
项导文档站总字数达 17W,阅读量达 15W,共有 92 位成员、28 个组织加入建设。
2025-08-06
未来
我们的故事还在继续,欢迎加入建设!
2077-07-07
贡献者
更新日志
a6517-feat(vercount):于e4d41-docs(begin):于f2b90-refactor: simple refactor于19b46-docs: add new paras于9d7a0-docs: improve docs于80b8d-docs: improve docs于40190-fix: component recognition于c537a-feat: add @vercel/speed-insights-vue plugin support于d9393-feat: add infrastructure development details and performance improvements to begin.md于22028-docs: add milestones and future outlook to begin.md于