一周年：持续建设本土化中文文档知识库

🎉 一周年，值得认真记录

在去年的今天，简中文档还只是一个很朴素的想法：能不能把优秀的开源文档，用更稳定、更适合中文开发者阅读的方式，重新带回中文互联网？

这篇文章想认真记录一下这一年的来路：为什么开始做这件事、这一年做成了什么、有哪些真实的数据反馈，以及接下来准备继续把哪些基础打牢。

如果你是第一次知道简中文档，也欢迎把这篇周年回顾当作项目介绍来看。👋

🤔 为什么还要做中文文档？

在编程开发领域，英语几乎是默认语言。大量优秀的开源项目只提供英文文档，这并不意味着中文开发者“看不懂”，而是意味着大家往往要付出更高的阅读成本、理解成本，以及长期查阅的时间成本。

很多人会问：现在浏览器翻译不是已经很成熟了吗？

答案是，浏览器翻译确实解决了“能不能看懂”的问题，但还没有完全解决“能不能顺畅地读、稳定地用、长期地查”的问题。尤其在这些场景里，差异会非常明显：

• 代码、术语、表格和导航混杂在一起时，语义可能会被误伤。
• 文档结构复杂时，自动翻译容易出现排版错乱。
• 统一化、可搜索、可持续维护的中文内容会更有价值。

也正因为这样，我们越来越相信：

🌱 项目是怎么开始的？

这件事的起点，其实非常偶然。

之前在给 Vue.js 中文文档 贡献翻译时，我们就在想：既然大多数开源项目的文档本身也是开源的，那是不是可以先 Fork 一份到自己的仓库里，进行持续翻译和部署，让更多中文开发者能够直接访问到更稳定的中文版本？

去年四月在辽宁出差的时候，客户现场停产的那几天，意外多出了连续几天完整的空闲时间。就在酒店里我们创建了 第一个 Git 仓库，也提交了第一个 Commit。

最开始，这只是一个帮助自己学习和查阅的个人实践。后来当我们开始翻译第二个项目时，一个更明确的想法慢慢浮现出来：不止做某一个项目的中文文档，而是逐步搭建一个可以持续生长的中文文档生态？

🧩 为什么要叫做简中文档？

2024 年 4 月 29 日，从辽宁出差回来的第二天，我们注册了 zhcndoc 这个 GitHub 组织，也注册了 zhcndoc.com 作为项目的统一入口，所以我们把这一天视为简中文档的正式成立时间。

zhcndoc 这个名字也有一点小巧思：

• 参考 BCP 47 (Best Current Practice 47) 标准的语言标签
• 项目名里借用了开发语境里更常见的 zh-CN 这种视觉形式，表示简体中文
• 第二段 doc 来自 Document，有文档和文献的含义
• 合在一起就是 zhcndoc，也就是“简体中文的文档资料”

如果用一句话来描述它，我们会这样说：

项目地址如下：

• 项目官网：https://www.zhcndoc.com
• 项目仓库：https://github.com/zhcndoc

🚀 这一年我们做成了什么？

截至目前，简中文档已经维护了 25 个开源项目 的中文文档，其中 7 个 以官方文档镜像的方式提供访问。

对我们来说，最重要的不是“数量”本身，而是它验证了一个判断：中文开发者对高质量、本土化、长期可访问的技术文档，确实有稳定而真实的需求。

这一年里，Nuxt 中文文档 是访问量最高、也是最常被开发者提起的项目之一。下面这些项目，也都是我们认为非常值得收藏和长期使用的中文文档：

如果你想看看目前支持了哪些项目，可以前往官网的 项目探索 页面。

📈 数据会给我们指明方向

过去这一年里，我们几乎没有正式宣传过简中文档。除了在 issue 里偶尔提起，或者在群里推荐给群友之外，这个项目基本上是靠搜索引擎的自然流量一点点长起来的。也正因为如此，这些数据对我们来说格外有意义。

自 2024 年 5 月 31 日接入 Umami 统计以来，截至 2025 年 4 月 29 日，简中文档累计获得了：

• 454,142 浏览量
• 75,532 访问次数
• 40,134 名访客

流量来源也很有意思。按 Umami 的来源统计来看，百度和 Bing 是最主要的搜索引擎引荐来源：

• 百度相关来源带来 25,239 次浏览
• Bing 相关来源带来 3,775 次浏览

这说明一件事：即使没有大规模宣传，只要内容真的能解决问题，它就会被持续找到、持续使用。📊

🔎 搜索引擎给我们上了一课

在网站 SEO 方面，根据站长工具查询，截止目前百度权重为 2，搜狗和必应权重为 1。

如果把这一年的搜索引擎表现做一个简单总结，大概是这样：

• 百度：收录之后一直比较稳定，关键词排名和曝光都保持在一个不错的状态。
• Google：对新网站依旧不算友好，目前整体曝光还比较有限。
• Bing：在 2024 年 11 月曾对 zhcndoc.com 全域屏蔽，导致收录被清空；前段时间经过多次申诉后，才逐步恢复收录和权重。
• 搜狗及其他搜索引擎：暂时没有做太多针对性的优化。

这些经历也提醒我们，做内容本身很重要，但如果想让内容稳定抵达更多人，基础设施、SEO 和站点可用性同样不能忽视。🛠️

🛠️ 接下来需要把基础打扎实

如果说第一年更像是“把种子种下去”，那接下来，我们更希望简中文档能进入一个“稳步建设”的阶段。

相比继续单纯追求项目数量，我们更想先把这些基础工作做好：

• 完善翻译规范，让术语、风格和表达更加统一。
• 优化贡献流程，让更多人可以更轻松地参与翻译和协作。
• 持续补充高质量项目，但优先保证已有内容的维护质量。
• 继续打磨网站体验、收录表现和整体可发现性。

简中文档现在依然处在早期阶段，还有很多地方不够完善。但也正因为它还在生长，所以每一条建议、每一次反馈、每一个贡献，都会真正改变它接下来的样子。

❤️ 感谢每一位来过这里的人

过去这一年，简中文档没有密集宣传，也没有刻意制造声量，但依然被很多开发者通过搜索、收藏、引用和口口相传的方式找到。

它说明，中文开发者需要的不只是“能看懂”的文档，而是值得长期信任、可以反复回来的文档入口。

如果你也认同这件事的价值，欢迎一起参与简中文档，提出建议、交流想法，或者直接加入贡献。希望在第二年，我们能一起把这件事做得更稳，也做得更久。🚀