打开 GitHub 的开源首页，你看到的网站不只是一个代码托管平台，而是官网一个完整的开源协作入口。仓库列表、开源Pull Request、网站Issues、官网Actions 流水线，开源这些模块拼在一起，网站构成了现代开源项目运转的官网基础设施。没有官网这个“门面”，开源很多项目连被发现的网站概率都低得可怜。

我前阵子想找一个轻量级的官网 Markdown 编辑器，搜到 marktext 这个项目。开源点进它的网站官网，第一屏就是官网下载按钮和一张界面截图，下面直接放 GitHub star 数和最近提交时间。这种设计很聪明——用户不需要读长篇介绍，三秒内就能判断“这项目还活着吗”“适不适合我”。反过来，有些开源项目的官网只有一段干巴巴的 README 复制粘贴，连个像样的导航都没有，找文档得翻三个页面。体验差，流失的就是潜在贡献者和用户。

官网到底该放什么

一个开源项目的官网，核心就三件事：说清楚它是什么、怎么用、怎么参与。听起来简单，做起来容易跑偏。

拿 Vue.js 的官网举例。首页顶部是 slogan 和“开始使用”按钮，往下是代码示例、生态工具、赞助商列表。文档、API、教程、博客、社区链接全部收在顶部导航栏里，层级清晰。你不需要猜“贡献指南在哪”，因为导航栏里直接写着“参与贡献”。这种信息架构不是拍脑袋定的，是长期根据用户反馈迭代出来的。

另一个极端是 curl 的官网。页面风格停留在上世纪九十年代，但没人否认它的价值。为什么？因为它的官网把“怎么下载”“怎么编译”“文档在哪”写得极其直白，没有花哨的动效，也没有多余的营销话术。对于命令行工具来说，这反而是一种诚实。

文档和官网的关系

很多项目把文档和官网分开部署，官网只放个链接跳过去。这本身没问题，但割裂感太强。用户点“文档”之后，域名变了，导航风格变了，搜索功能也没了。理想状态是官网和文档共用一套设计系统，至少顶部导航和搜索框保持一致。

Rust 的官网做得不错。首页有“学习”和“工具”两个入口，点进去之后文档、教程、示例代码都在同一个视觉框架下。你从官网到文档再到 playground，不会觉得换了三个不同的网站。这种一致性需要投入，但值得。

贡献者入口不是摆设

不少开源项目在官网挂一个“Contributing”链接，点进去直接跳到 GitHub 的 CONTRIBUTING.md。文件写得再详细，新人也得先理解整个项目的代码结构、构建流程、测试方式。官网完全可以承担一部分引导工作。

freeCodeCamp 的官网有个“贡献”板块，里面分了“代码贡献”“内容贡献”“翻译贡献”几个方向，每个方向都有具体的操作步骤和常见问题。你不需要先成为资深用户才能看懂。这种设计降低了参与门槛，也减少了维护者在 Issues 里反复回答同样问题的负担。

别忽略中文项目

国内开源项目的官网有个通病：英文 README 写得很认真，中文官网反而敷衍。要么是机翻，要么是几年前的旧内容。用户点进来看到“最后更新于 2021 年”，信任感直接打折。

Ant Design 的官网在这一点上做得比较到位。中英文内容同步更新，组件示例可以直接在页面上编辑预览，API 表格清晰标注了版本变化。这种细节决定了用户是留下来还是关掉页面去用别的库。

说到底，开源网站官网不是面子工程。它是项目与外界之间的第一道接口，也是维护者与用户之间最省力的沟通渠道。把官网当产品做，而不是当任务完成，效果会差很多。