从零开始，用GitHub Pages搭建你的个人学术主页

本教程面向纯小白，不讲复杂代码，只讲一个道理：个人学术主页，本该是每个人都能轻松拥有的东西。

无论是保研、申博，还是联系国外导师，一份像样的个人主页已经成为学术圈的“标配名片”。过去，做网站需要买域名、买服务器、学前端，门槛高得吓人。但现在，有了一条完全免费、零基础的捷径：GitHub Pages + Academic Pages模板，不到半小时就能上线一个专业、美观的个人学术主页。

今天就带大家手把手走一遍，顺便介绍张晨斌（Chenbin Zhang）的个人主页项目，不仅能学会使用，还能帮你彻底看懂这套模板的每一块“积木”是怎么搭起来的。

🎯 这个项目是什么？为什么选择它？

先来看一下最终成果：张晨斌（Chenbin Zhang）的个人主页，基于 Academic Pages 模板搭建。

• GitHub仓库链接：https://github.com/ace-trump-tech/Chenbin_ZHANG.github.io
• 最终上线地址：https://ace-trump-tech.github.io/Chenbin_ZHANG.github.io/

一、背景：它从哪里来？

Academic Pages 是一个专门为学术圈设计的 GitHub Pages 模板。它被 Fork（相当于“复制”）自 Minimal Mistakes Jekyll 主题，并在其基础上增加了专门给学者用的功能——用来展示论文、演讲、教学经历、项目作品集等。你看到的所有设计都经过学术圈实际检验，是为展示科研成果量身打造的。

二、为什么值得你用？

1. 完全免费：基于 GitHub Pages 托管，不需要花一分钱买域名和服务器。
2. 零门槛：不需要会写代码。写文章用 Markdown（一种简单到10分钟就能学会的标记语言），填信息按 YAML 格式就行。
3. 专业设计：功能完全匹配学术需求——Publications（论文）、Talks（报告）、Teaching（教学）、Portfolio（项目作品集）等模块全部内置。
4. 完全可控：数据和代码都在你自己的 GitHub 仓库里，不会被任何平台“绑架”。
5. 内容与样式分离：论文列表和个人介绍存在 Markdown 文件中，样式和布局存在主题文件中。改样式不影响内容，改内容也不怕搞乱布局。

🚀 最简单的上手方式：直接使用这个模板

第一步：注册GitHub账号

访问 GitHub 官网，按流程注册账号并完成邮箱验证（必须验证，否则无法启用 GitHub Pages）。

第二步：复制（Fork）模板

访问项目主页 https://github.com/ace-trump-tech/Chenbin_ZHANG.github.io，点击右上角的“Use this template”→“Create a new repository”。在弹出的页面上，仓库名必须填：你的GitHub用户名.github.io——如果你用户名是zhangsan，仓库名就是zhangsan.github.io，这将成为你的个人主页域名。

第三步：修改基本信息（这是最关键的一步）

找到仓库里的_config.yml文件并打开（点击文件名，再点铅笔图标 ✏️ 编辑）。这是整个网站的总控制台，你需要改的核心内容都在这里：

# 网站基础信息title:"你的名字"# 浏览器标签页显示的标题name:"你的名字"# 网站显示的作者名description:"一句话介绍你自己"# 网站描述# 作者信息（侧边栏显示）author:avatar:"avatar.jpg"# 头像图片，放到 images/ 目录name:"你的名字"bio:"你的研究领域/简短介绍"location:"中国"email:"你的邮箱@xxx.com"# GitHub Pages关键配置——这两项改错了网站会样式错乱url:"https://你的GitHub用户名.github.io"# 一定要填对baseurl:""# 这里留空，不要乱填

📌特别注意：url和baseurl只要改错一处，网站就会变成纯文本、没有任何样式。如果你看到网站样式错乱了，第一时间检查这两个配置。

第四步：写你的个人介绍

打开_pages/about.md文件进行修改，这是你的主页核心内容。支持 Markdown 语法，你可以写教育背景、研究方向、荣誉奖项等。

--- permalink: / title: "你的名字" author_profile: true --- ## 关于我 这里是你的个人介绍。 ## 教育经历 - **某某大学** (时间) - 专业/学位 ## 研究方向 - 方向一 - 方向二

👉更详细的图文操作教程，请参考张晨斌写的 CSDN 完整教程：【DIY搭建网站（学术个人介绍主页）】(https://blog.csdn.net/qq_63129682/article/details/144175266)，里面一步步截图，非常清楚。

第五步：等待部署

完成修改后，点击Commit changes保存。稍等1-2分钟，访问https://你的GitHub用户名.github.io，就能看到你的个人主页了。之后每次修改内容、提交代码，网站都会自动更新。

📁 项目的每一个文件是干什么的？超详细拆解

下面这张“文件地图”对照仓库里的实际目录，帮你一眼看懂每块内容应该放在哪里、有什么作用。

📄 根目录：启动器与总控

_config.yml- 总控制台
你之前在第三步改的就是这个文件。它控制网站标题、作者信息、社交链接（GitHub、谷歌学术、领英等）、构建方式等一切全局设置。⚠️ 这里一旦出错，整个网站的样式就会乱掉，因此修改时务必小心，做好备份。

Gemfile和Gemfile.lock- 依赖清单
记录了网站运行所需的 Ruby 工具包和版本。当你在本地预览网站时，运行bundle install就会根据它自动安装所有依赖。

README.md- 项目说明书
用户在 GitHub 上看到的介绍页面，详细说明了使用方法。张晨斌的 README 已经翻译成了中英文双语版本，方便中外用户使用。

screenshot.jpg- 预览图
在 GitHub 仓库页面展示的网站外观截图。

talkmap.ipynb和talkmap.py- 演讲地图小工具
用于生成演讲地理位置分布图的辅助脚本，属于进阶功能。

📁_pages/：所有的“大页面”

• about.md：整个网站最重要的文件，决定了主页长什么样。张晨斌在里面详细介绍了自己的教育背景、科研项目、技能证书、荣誉奖项等信息。其中author_profile: true表示开启侧边栏显示作者信息卡。

• cv.md、publications.md、talks.md等：展示个人简历、论文列表、学术报告的独立页面。

📁_publications/、_talks/、_teaching/、_portfolio/：四大核心模块

这些文件夹里放的是学术履历的核心内容，是Academic Pages区别于普通博客模板的最大亮点。

• _publications/：放你的论文条目，每个文件一篇论文，包含标题、作者、期刊/会议、年份等信息。
• _talks/：放你的学术报告记录，按时间组织。
• _teaching/：放你的教学经历（助教、主讲过的课程等）。
• _portfolio/：放你的项目作品展示，比论文更灵活，适合展示软件、数据集等产出。

📁_layouts/、_includes/、_sass/：让网页好看起来的秘密武器

这三兄弟是Jekyll的“骨架+皮肤”，一般不用动它们，但知道它们的作用对理解网站运行很有帮助。

• _layouts/- 页面骨架：存放页面的大框架模板（default.html是基础框架，about.html是专属布局等），定义了页面的基本结构。
• _includes/- 可复用部件：存放可以被反复引用的代码片段（header.html导航栏、footer.html页脚、head.html网页头部信息等），改一处就能影响全局。
• _sass/- 样式表：.scss文件，决定了网站的颜色、字体、间距等视觉风格。

📁 内容类文件夹：日常更新就靠它们

_posts/- 博客文章
如果想写技术博客或学习心得，在这里新建 Markdown 文件，文件名严格遵循YYYY-MM-DD-标题.md格式。

_data/- 结构化数据
存放.yml或.json格式的数据文件。最常用的是navigation.yml——导航栏菜单的配置文件，修改它可以改变顶部导航栏的链接。

📁assets/、images/、files/：存放所有素材

• assets/：核心静态资源，如 CSS、JavaScript 脚本。
• images/：放头像、文章配图等图片素材。
• files/：放 PDF 简历、论文原文、课件等文件供访客下载。

📄 周边支持文件

• LICENSE：开源许可证（MIT协议），说明别人可以怎样使用你的代码。
• CONTRIBUTING.md：贡献指南，方便其他人参与改进项目。
• .gitignore：告诉 Git 忽略哪些文件。
• Dockerfile：Docker容器配置文件，如果你不想在本地安装依赖，可以用 Docker 一键运行网站预览。

❓ 常见问题：小白一定会遇到的坑

1. 部署后网站是纯文本，完全没有样式
→_config.yml里的url和baseurl配错了。url必须是https://你的用户名.github.io，baseurl保持空字符串""。修改后重新推送即可。

2. 修改了about.md，主页为什么没更新
→ 确保文件开头的permalink: /这一行存在且没有被注释掉。

3. 本地预览和线上效果不一致怎么办
→ 在Gemfile中指定gem "github-pages"，让本地版本和 GitHub Pages 所用的版本保持一致。

🎓 进阶玩法：让网站更个性化

修改主题颜色：_sass/_variables.scss文件里找到$primary-color变量，改颜色代码就能更换网站主色调。

启用学术社交链接：在_config.yml的author里填写 GitHub、谷歌学术、领英、ORCID 等ID，侧边栏会自动出现对应的图标和链接。

添加本地预览环境：如需在正式发布前预览效果，可按照README.md中的指引在本地运行bundle install和jekyll serve，然后在localhost:4000查看实时预览。

💡 总结

GitHub Pages 把建站的门槛降到了几乎为零——你不需要买服务器、不需要懂后端，甚至不需要会写 HTML/CSS。而张晨斌的这个 Academic Pages 项目，把“个人学术主页”这件事又往前推了一大步：它是一个零成本、零门槛、可复制的解决方案，任何人都可以在半小时内拥有一个专业、美观的学术展示窗口。

所以，别等了，直接从下面的链接开始行动吧。

🔗 相关链接汇总

• 🎓张晨斌的GitHub项目仓库：https://github.com/ace-trump-tech/Chenbin_ZHANG.github.io
• 🌐最终上线的主页：https://ace-trump-tech.github.io/Chenbin_ZHANG.github.io/
• 📘更详细的完整教程（含图文步骤）：👉 DIY搭建网站（学术个人介绍主页）
• 📄Academic Pages 模板官方文档：https://academicpages.github.io/

如果过程中遇到问题，欢迎在 CSDN 教程评论区留言，张晨斌会为你解答！