V2EX = way to explore
V2EX 是一个关于分享和探索的地方
Sign Up Now
For Existing Member Sign In
This topic created in 1001 days ago, the information mentioned may be changed or developed.
这些年接触过不少国内开源的项目，例如阿里、腾讯、百度这些大公司或者一些个人的开发者。在项目开源初期甚至是中后期，有一些项目都缺乏中文文档，只提供英文文档。有的中文文档还是第三方翻译，非官方的。
 |
1
l0wkey Aug 2, 2023
盲猜是为了过滤低质用户。
比如能拦住一些伸手党？然后真正有需求、有能力回馈社区的开发者，可能不在意这点语言门槛 |
 |
2
clino Aug 2, 2023
因为英文面向的用户更广啊
现在机翻这么方便，给英文和中文文档其实区别不太大 |
 |
5
inhzus Aug 2, 2023
很简单的道理啊... 英文文档能看懂的人多啊
|
 |
6
libook Aug 2, 2023
英文已经不是特定地区或者人群的专用预言了，而是一种全球化工具，所以如果项目是面向全球的，首选就是英文。
一个项目足够火，自然就会出现其他语言的文档，每天新出现的轮子那么多，肯定不可能全都出翻译版本。 |
 |
8
geelaw Aug 2, 2023 via iPhone
功利的原因是先进的技术是先用英语写出来的，哲学的原因是没有在这方面追求文化认同。
提升到先进生产力（自由软件、开源软件、科研都是某种先进生产力），我最近的实践是两者结合，写文章还是会用英文，在国内学校作报告会坚持用汉语。 |
 |
9
nothingistrue Aug 2, 2023
首先，双语文档的成本非常高。
其次，跟什么人交流用什么语言。如果你是打算跟全世界人交流的，那么自然要用实质上的世界通用语——英语。你要玩游戏就会知道，全套都是法国人的育碧，其发行游戏的第一语言基本都是英语。如果你只打算跟国内的人交流，那主体语言肯定是母语。然后因为你不可明说的原因，压根就不可能存在国内社区。 |
 |
10
AppJun Aug 2, 2023
作为开发者，我想了下主要是以下几个原因：
1. 面向受众的语言是不特定的情况下，英文是覆盖率最广的。 2. 维护多套语言的文档其实是会增加代码无关工作量的，对于很多开发，让提供英文文档已经很艰难了。 3. 哪天偷懒导致中文或者什么非英文版本语言的文档内容过时了，可能会造成另外一种麻烦。 4. GitHub 对于 ReadME 多语言支持没有一个特别好的实践。 和文化认同啥的其实关系不大，说来说去就是成本低麻烦少。 |
 |
11
nightwitch Aug 2, 2023 via Android
看不懂英文文档的不是目标用户
|
 |
12
z1645444 Aug 2, 2023 via Android
好像月初某天如厕时在知乎看过一样的话题
|
 |
13
dayeye2006199 Aug 2, 2023 via Android
@cx2ex 不是英文弱的是低质用户，是低质用户伸手党戾气党，一般英文水平都没很好
|
 |
14
me1onsoda Aug 2, 2023
母语是中文，写英文文档的时候脑子也是先有中文再翻译成英文，写个中文文档不是顺手的事？
|
 |
17
Pencillll Aug 2, 2023 via Android  17
按照我的个人经验，但凡项目里出现了任何汉字，包括文档/注释/作者用户名，那么 issue 里基本上就全是中文了，如果你想让他们在 issue 里讲英文以便非中文用户检索，还会立刻被扣上一顶崇洋媚外的帽子并骂上一长串回复，所以我认为避免中文是最好的选择
|
 |
18
9dP06m83vIV00l72 Aug 2, 2023
我的主要项目 [袋鼠数据库工具] 第一语言是英语，刚开始有装逼的成分，然后是考虑到国外用户赞助、支持可能性更大，再后面是考虑到沟通国外用户更方便，其实写英文文档的成本更高，经常要借助语法类工具校正语法。
当然啦，中文也是一开始就有提供的，就是因为输出成本低，一口气就搞出来了。 |
 |
19
liveoppo Aug 2, 2023
不必添加英文之外的版本，机翻足够，看不懂的地方再去看英文即可
未来修改也方便，仅仅一个地方修改 |
 |
20
smilenceX Aug 2, 2023
和用户质量没关系。如果你这个项目面向全球，用英语是最好的选择。如果只是给中国人用，确实用中文更合适。
|
 |
21
Rache1 Aug 2, 2023 1
 |
 |
22
BifroMQ Aug 2, 2023
@clino 同意，我理解是对受众群体的选择原因。
比如开源个做小程序的框架，就很少有团队会只写英文文档，甚至完全不会去写英文文档，因为受众全部在国内。 但是如果是底层框架、中间件之类，一般会出英文文档。 比如我们的 https://bifromq.io/ 开源 MQTT 消息中间件，就因为要同时兼顾海外&国内用户做的双语文档。 当然，维护成本确实也确实高不少。 |
 |
23
cbythe434 Aug 2, 2023
背靠大公司，做开源老板基本都有海外背景，或者要向海外竞品对标
东西好不好不重要，英文舞台更大，彰显影响力，中文显得格局小了 |
 |
24
Biggoldfish Aug 2, 2023
因为不指望读英文文档都费劲的会给你认真提 issue 更不用说是开 PR 回馈了
|
 |
25
fzls Aug 2, 2023
因为现状是会参与进来提 pr 的大部分是国外人吧-。-而且很多这类产品的国外用户更多，也更愿意捐赠
|
 |
26
FeatureProbe Aug 2, 2023
以自己的开源项目为例（ https://github.com/FeatureProbe/FeatureProbe ），中英文都有，Github 的 readme 是英文，如果不想看英文也提供链接直接跳转到 Gitee 看中文，主要觉得英文不会受到语言限制，可以让更多人参与开源进来。
|
 |
27
tin3w5 Aug 2, 2023 via iPhone
答案就在问题里，人家是开源项目。文档当然是越多人能读懂越好，用户是文档的一个受众群体，另一个更大的群体是开源代码贡献者。
另外，很多国内组织主导的开源项目被某些有背景的商业利益公司搞的名声很臭，要么不完全开源，想要完整版就要付费。要么开源出来的东西几百辈子不维护，大家提的 pr 几个月都没人管。很多国内个人搞的开源项目都尽可能伪装成国外的开源爱好者或团队，搞出口转内销。 |
 |
28
NoOneNoBody Aug 2, 2023
当然是 —— “我想和谁交流”
|
 |
29
yzbythesea Aug 2, 2023
1.简中巨婴多
2.和老外交流有新鲜感 3.开源一般技术新，很多新技术都没中文文档，中英夹杂写蛋疼 |
 |
31
28Sv0ngQfIE7Yloe Aug 2, 2023
过滤 提纯
|
 |
32
jsq2627 Aug 2, 2023 1
https://www.jetbrains.com/lp/devecosystem-2022/
Which language do you mainly use at work? 67% English 20% Chinese What languages do you use with family and friends? 15% English 14% Chinese |
|
33
jsq2627 Aug 2, 2023
@Pencillll 我再补充一点，但凡项目里出现任何一个汉字，外国人的好感度也会下降很多，会阻碍开源项目的全球推广。例如：
- README 和文档是略显憋足的英文，issue/PR 区全是中文 - 作者用中文在 issue/PR 里沟通 - 提供中英双语文档 反面案例：ant design 正面案例：vue |
 |
35
MeMoDiv Aug 2, 2023
一个简单的例子
|
|
36
MeMoDiv Aug 2, 2023 1
|
 |
37
snw Aug 2, 2023
因为不用切换输入法啊
|
|
40
MeMoDiv Aug 2, 2023
@ming2077 #37 这还真是充分条件，英文弱到没有办法做可以用翻译工具辅助的无限时阅读理解的话，基本没可能自己解决部署使用开源项目过程中会遇到的问题，万一被百度上的教学灌输了“issue 是用来找客服的”这种观念，后果不堪设想。不是必要条件是因为有的人英文足够好，但却是纯脑残，这和在开源坑里叫天天不应叫地地不灵的可怜小白也有本质不同。
|
 |
41
xiaowowo Aug 2, 2023
因为英文是国际化语言。
|
 |
42
lance6716 Aug 2, 2023 via Android
我自己的项目，中文 issue 我一般都直接无视的
|
 |
43
RomeoHong Aug 3, 2023 1
这个问题和这个论文要不要提供中文版本 https://www.v2ex.com/t/955402 是相似的。其实有没有中文文档可以说是个人意愿，我并不在意。为什么不在意呢，因为总结楼上这些言论，我要做出一个违背祖宗的决定。以下是决定总结经过：
#4 英文弱等于低质用户 ---> 英语高级 #17 中文用户素质低 ---> 用英语的人素质高 #33 要对外国人友好 ---> 外国人高级 我决定： 1 ）开源项目我只会用高级的高素质的英语母语开发者开发的高级开源项目，所以有没有中文我并不在意。 2 ）我所使用的的开源项目都会严查开发者的信息，祖上十八代只要有会过中文的都不行。 3 ）决不使某些国内开发者开发的面向会使用高级英文的外国人的所谓的开源项目。 注：也别以为只写英文文档穿个马甲，我就看不出来。 |
 |
44
736531683 Aug 3, 2023
你在 github 不用英文为什么不去 gitlab 呢
|
 |
45
Sylarlong Oct 7, 2023
|
Select Language