这是一个创建于 483 天前的主题，其中的信息可能已经有所发展或是发生改变。
起因是写了一个开源的项目： https://github.com/wy-luke/StableDiffusion-Installer-For-Mac （原谅我打了个广告）
在里面写了两份 README ，中文和英文的，纠结了好久，是中文放在首页还是英文放在首页
会考虑很多因素
一方面，这里毕竟是英文为主的社区嘛，作为程序员大家应该都理解，这个应该就不用多解释了
另一方面，觉得自己作为中国人，用母语无可厚非，也能宣扬一下我们国家，同时也是怕被喷，我见过不止一次有人喷，作为中国人但是 README 放的却是英文这件事了
我最终把英文放在首页是因为，看到阿里的一些仓库采用的也是英文，最终一狠心用了英文
我确实是自己想的多，也知道不用太在意别人的看法，自己的项目想怎样就怎样
这里我们不去说哪个对、哪个错，无论哪种都有一定的道理，只是想和大家理性地探讨一下，看看大家更倾向于哪种方式，出于好奇，也出于寻求解决方案
可能有人没有做过相关工作哈，那就假设，如果你有一个开源项目，你会怎么选择，为什么？
想做一个简单的投票，分别在 1 楼和 2 楼回复两个选项，如果你更倾向于某种方式，可以为其加个感谢
（感觉有点像骗感谢来了。。。）
第 1 条附言 · 2023-08-31 19:29:05 +08:00
目前来看，其实大多数还是倾向于使用英文的
这个结果其实是意料之中，一来大家素质水平较高，都互相理解，不会因为这点小事喷人，二来程序员居多
但有些回复还是有点跑偏了，“见人说人话，见鬼说鬼话”，这是固然，当我的产品仅面向中文用户，我会毫不犹豫地使用中文，甚至可能不会写英文文档
这个帖子想和大家讨论的是，我们抛开其他的一切，不管你的英文好或不好，不管你有没有项目，你的产品受众也是两开花，难分伯仲，此时，你会如何选择？
把英文放在首页，主要更新，附一个中文文档链接；还是中文放首页，附一个英文文档链接？为什么
 |
1
EatMi OP  3
中文
|
|
2
EatMi OP 9
英文
|
 |
3
xipuxiaoyehua 2023-08-31 13:32:45 +08:00 3
技术类的我会更偏向于使用英文
|
 |
4
jstony 2023-08-31 13:34:24 +08:00 4
看情况，面向的主要是中文受众就中文，面向的主要是英文受众就英文。
|
 |
5
artnowben 2023-08-31 13:35:05 +08:00 1
我在做 dperf 的时候，也考虑过这个问题，最终是中英文都有，英文方便国际化，中文方便国内用户，有中文、英文切换的链接。
https://github.com/baidu/dperf/ |
|
9
artnowben 2023-08-31 13:36:45 +08:00 1
dperf 最终只会用英文，维护中英文太费精力了
|
 |
10
zhangxh1023 2023-08-31 13:37:20 +08:00 1
英文写的够好，自信，就优先英文 😂
|
 |
11
kdwnil 2023-08-31 13:37:46 +08:00 via Android 1
自娱自乐的项目懒得翻译/仅面向中文用户（比如外语翻译成中文）用中文，其余用英文然后随缘附加中文 readme
|
|
12
EatMi OP @jstony 了解你的意思，谢谢。有时候我确实会难以判断出，项目的“主要”受众是哪边。但是看大多数这种情况下，会采用英文作为首选，然后附上中文链接
|
|
13
EatMi OP @xipuxiaoyehua 好像确实大多数也是这样，就比如国内一些大厂的开源项目，除非是很“鲜明”地面向国内用户，一般的技术项目都会采用英文首选
|
|
14
EatMi OP @zhangxh1023 以前可能确实有英文水平这个问题在，但是现在有了 ChatGPT 的加持，自己再稍微改改，写出一份质量不错的英文文档不算特别困难
|
|
17
EatMi OP @artnowben #5 哇，刚注意到，是百度的大佬呢。公司内部在做这种项目的时候，关于英文首页还是中文首页，会有相关规定吗？还是说全凭开发者习惯
|
 |
19
kongkx 2023-08-31 14:02:15 +08:00 via iPhone 1
中英写在一个文件里面如何
|
 |
20
cnbatch 2023-08-31 14:04:54 +08:00 1
目标用户是中文用户的话，就用中文 + 英文链接；否则就英文 + 中文链接。
到目前为止，我个人的项目都明确考虑过用户群，所以不会在中文还是英文浪费过份的时间 至于我工作时公司的项目……都是内部使用的，不对外开放，说出来没意义。 |
 |
21
janus77 2023-08-31 14:07:10 +08:00 1
我同意按主要受众为标准的办法
如果你不确定谁是主要的，看看你的宣传阵地，你如果在中文社区宣传多，引流来的中文用户就多，issue 里面提中文的也多。 |
 |
22
lifesimple 2023-08-31 14:07:27 +08:00 2
|
|
23
EatMi OP @lifesimple #22 鬼才
|
 |
24
villivateur 2023-08-31 14:21:52 +08:00 1
@lifesimple 这还是有偏有倚的，凭什么中文文档在左，英文在右[/狗头]
|
|
25
EatMi OP @villivateur #24 鬼中鬼才
|
 |
26
cwcc 2023-08-31 14:27:26 +08:00 1
|
 |
27
skiy 2023-08-31 14:29:25 +08:00 2
我见过小程序的 README 用英文的。
笑不活了。老外的软件有小程序的吗？或者说有外包开发小程序开发给老外的吗？ |
 |
28
duzhuo 2023-08-31 14:36:31 +08:00 via Android 1
见人说人话 见鬼说鬼话
|
 |
29
WillBeethoven 2023-08-31 14:39:16 +08:00 1
默认英文，只面向中文网站/内容的项目才用中文。
|
|
30
EatMi OP @skiy #27 其实也可以理解，一方面可能作者是出于练习目的，尝试使用英文 README ，另一方面，我们不得不承认，有时候英文就会显得更“专业”😂
|
 |
31
callmesmc 2023-08-31 15:34:59 +08:00 via iPhone 1
我也见过喷别人 readme 不用中文的，感觉好奇葩，为什么默认作者和其他用户都是中国人
|
 |
32
kwanzaa 2023-08-31 15:54:50 +08:00 1
见人说人话，见鬼说鬼话。
要不就默认 En ，给个 Zh 的超链。 |
 |
33
Pencillll 2023-08-31 16:03:21 +08:00 1
用英文一劳永逸，老外和大部分国人都能看懂
以前还会额外提供中文版，现在不打算提供了，本来写文档就又费劲又无聊，维护两份文档直接超级加倍，还要考虑是否同步的问题，不如把精力省下来多写点代码 |
 |
34
Lockeysama 2023-08-31 16:05:41 +08:00 1
本来想房中文的，后来放了英文，因为之前写了 Python 的 SDK ，因为 setup.py 里面引用了中文 readme ，导致在 Windows 下安装 SDK 一直编码报错。后来就索性直接用英文了。
|
 |
35
qquantt 2023-08-31 16:07:08 +08:00 1
不用局限在 README
我和我妈只说村里话，和中小学同学基本说县里话，会中文的朋友我就说中文，以上都不会就英文，英文还不行就找个翻译机器。 |
 |
36
tool2d 2023-08-31 16:08:19 +08:00 1
这就和软件是否需要出多语言版本一个道理，有人看还是需要的，毕竟有需求在。
有 gpt 帮助，翻译一般来说不是太大的问题，比以前没有的时候，要省力多了。 |
 |
37
flyqie 2023-08-31 16:13:16 +08:00 via Android 1
default eng
|
 |
38
jadelike 2023-08-31 16:14:16 +08:00 1
中文，因为我看不懂英文
|
 |
39
fredweili 2023-08-31 16:38:05 +08:00 1
github 上不写英文，就是想内卷
|
 |
40
TianHeiLeKuaiPao 2023-08-31 16:45:22 +08:00
预测又是一个撕逼贴
|
 |
41
LitterGopher 2023-08-31 16:45:27 +08:00 1
中文开发者能看懂英文文档是基本需求，反过来却不是。直白的说就是，写英文版传播范围可能会更广（也只是可能）。
|
|
42
EatMi OP @TianHeiLeKuaiPao #40 也不能这么说，目前为止大家的讨论还是很友善的。不去说谁对谁错，谁优谁劣，这个前提下其实也不太容易撕起来，这样挺好
|
 |
43
FeatureProbe 2023-08-31 16:53:37 +08:00 1
Github 是英文，提供了中文链接，如果不想看英文可以直接跳转到 Gitee 查看。
|
 |
44
jlmzzz 2023-08-31 17:54:27 +08:00 1
在大多数情况下，请使用英语。如果您想表示尊重，请加上中文。
|
 |
45
dabaibai 2023-08-31 17:57:39 +08:00 1
英文极其差 就用中文吧
|
 |
46
LykorisR 2023-08-31 18:03:07 +08:00 1
英文
|
|
48
EatMi OP @Lockeysama #34 确实，中文的这种兼容性比较棘手
|
|
49
EatMi OP @qquantt #35 对，理解你的意思，就是看目标用户嘛，但有时候就是没有一个“主要”的用户群，想两开花，在这种情况下的倾向性，是我想来讨论的
|
|
53
EatMi OP @FeatureProbe #43 嗯嗯，我看到你的项目是这样做的，但是我实在不喜欢 Gitee ，哈哈。我的看法是技术是中立的，GitHub 也不存在一个官方语言，只能说大家默认使用英文来，而且上面也有很多其他国家语言的仓库
|
|
54
EatMi OP @LitterGopher #41 对，这是一方面，英文能够做到兼顾，但是中文却不能
|
|
55
EatMi OP @fredweili #39 其实还好啦，都已经上 GitHub 了，无论带不带功利性的目的，做的东西起码都是免费分享给大家的
|
 |
57
dann73580 2023-08-31 21:38:20 +08:00
其实没什么对错，更多还是看产品市场吧。这是纯实用主义的角度。
当然，中文优先，对自己民族文化有认同，愿意使用并且推广，十分理解而且尊重。 不管怎么选，都是对的。看你价值观更侧重什么方面。 |
|
58
dann73580 2023-08-31 21:41:22 +08:00
@dann73580 补一句：如果你认为作品是自己的代表的话，我建议中文优先。开源本身就是一种政治倾向。立场鲜明的，自信的表达我是中国开发者，是非常有个性，也是非常酷的一件事。
|
|
59
EatMi OP @dann73580 #57 对的，没有孰对孰错，就只是个人倾向，对于你“开源是一种政治倾向”我不太认同，我认为技术就应该仅仅是技术，纯粹的技术，如果让技术染上政治，会有很多不必要的麻烦，比如美国如果严重制裁，就应该舍弃所有美国的开源相关技术吗，那肯定是做不到的。而且我们就只是想做做技术嘛，不想管那么多的有的没的，生活已经很不容易了。但是我尊重你的看法哈，现在也有很多开源仓库会有“支持乌克兰”等政治立场在。对于宣扬民族文化，我也认同，我也觉得很酷，这也是我会认真考虑使用中文有限的重要原因，否则我可能就直接使用英文了。
|
 |
60
joesonw 2023-08-31 22:21:55 +08:00 via iPhone 1
一般只用英文，要上 v 站宣传的时候会再 jiage 中文的。
|
 |
61
tyzandhr 2023-08-31 22:59:11 +08:00 via Android 1
拉丁语。
|
 |
63
maokabc 2023-08-31 23:10:20 +08:00 via Android 1
英文差，机翻英文还不如直接中文，毕竟还有大把喜欢替别人尴尬的人。外国人要用，他们自己机翻一下可能更准确。
|
|
66
EatMi OP @kongkx #19 对，文档较小的话确实可以，还方便，我的一个项目就是这样做的。那么问题又来了，是英文在上面还是中文在上面🤣
|
 |
67
Dipous 2023-09-01 01:17:31 +08:00
拿中文写的就中文，拿英文写的就英文呗
|
 |
68
hsfzxjy 2023-09-01 01:35:05 +08:00 via Android 1
一般只用英文，平时写英文多于中文
|
|
69
dann73580 2023-09-01 04:30:23 +08:00
@EatMi 这个是我没说清。我是说开源这个行为本身，就是一种理念。可能用政治理念这个词模糊了重点。所以优先中文，在不增加额外工作量的情况下，表达自己的理念，是非常酷且值得尊重的。
|
 |
70
voidmnwzp 2023-09-01 05:00:17 +08:00 via iPhone 1
给中国人用的就写中文，全球通用的 比如轮子之类的就用英文 我就是这样的
|
 |
71
iintothewind 2023-09-01 05:10:11 +08:00 1
默认肯定得是英文文档，然后在考虑中文文档，毕竟技术文档，英文更方便传播。
|
 |
72
baobao1270 2023-09-01 06:19:27 +08:00 1
我会提供中英双语，但是优先英文（ README.md 是英文，README_ZH.md 是中文）
|
 |
73
begeneral 2023-09-01 07:12:28 +08:00
有啥区别，甲骨文都行
|
|
74
kongkx 2023-09-01 07:24:11 +08:00 via iPhone
|
 |
75
klo424 2023-09-01 08:31:50 +08:00 1
现在都 gpt 翻译了，英文中文全写上也不费劲，个人比较喜欢中英文双语的写法。
例如： # 我的世界 Minecraft > 《我的世界》是一款沙盒类电子游戏，开创者为马库斯·阿列克谢·泊松。游戏由 Mojang Studios 维护，现隶属于微软 Xbox 游戏工作室。游戏最初于 2009 年 5 月 17 日作为 Classic 版本发布，并于 2011 年 11 月 18 日发布 Java 正式版。我的世界的游戏平台囊括桌面设备、移动设备和游戏主机。 中国版现由网易游戏代理，于 2016 年 5 月 20 日在中国大陆运营。 > > Minecraft is an open-world survival and multiplayer game, originally designed and created by Notch of Mojang. > Minecraft is available for PC, mobile and various gaming consoles, the game allows players to place and destroy a variety of blocks in a 3D environment. Within this 3D environment, players can roam around, free to do and build anything they want. |
 |
76
tairan2006 2023-09-01 08:34:45 +08:00 1
如果是给国人用的项目，当然还是中文优先
如果跟国别无关，一般优先英文 |
 |
77
themelody0 2023-09-01 08:39:35 +08:00 1
我曾经见过多次有用中文 README 被喷的
|
|
78
EatMi OP @begeneral #73 硬要说确实也没啥区别，影响不大。但不可否认这些东西还有会有一些意识形态的因素在里面的，只是想和大家理性讨论讨论哈，可以理解为纯粹是我的好奇，看看大家的想法
|
 |
79
chinaguaiu 2023-09-01 09:24:30 +08:00 1
很多中文项目自己刷星然后卖课，整个中文用户群体给人的印象瞬间不好了...写英文吧
|
|
80
EatMi OP @themelody0 #77 这种情况挺多的，令人不悦😑
|
 |
81
wyl986 2023-09-01 09:44:12 +08:00 1
在 GitHub 只使用英文可以过滤掉很大一部分垃圾用户和垃圾仓库
|
 |
82
wudicgi 2023-09-01 09:49:14 +08:00 1
我是把中英文写在一个 readme 里
如果分开的话，首页放英文的比较好 |
|
83
EatMi OP @chinaguaiu #79 这种情况确实，把脸丢到国外去了。
|
|
84
EatMi OP @wyl986 #81 我比较同意你的观点，能够起到过滤作用。但是我认为用户倒是没有垃圾、不垃圾之分，只要用我的产品，就是好用户哈哈。不过提问、建群之类的，使用英文或者 TG ，来过滤一下，会有很好的作用
|
 |
85
dog82 2023-09-01 10:12:34 +08:00 1
没人看，不写
|
 |
86
agagega 2023-09-01 11:17:32 +08:00 1
现在有了 ChatGPT ，不如再加上日文、德文、法文、西班牙文、俄文的 README 。
https://github.com/github/markup/issues/899 GitHub 用户希望能有多语言 README 支持已经很久了，只是迟迟没一个官方方案。起码法文的俄文的西班牙文的我都见过，人用母语不可耻 |
 |
87
RainCats 2023-09-01 11:23:03 +08:00 1
中文，如果其他语言群体有需要，他们会自行翻译，翻译工具这么多，甚至还有 AI 工具
|
 |
88
ZeroDu 2023-09-01 12:45:00 +08:00 1
两个都 提供，默认英文，毕竟 github 也是全英文的，英文也算是国际比较广泛的语种；
但是非常反感装老外，好像写中文掉价一样。同时国内程序员群体还是很大的，中文还是很有必要的。 |
 |
89
ryan4yin 2023-09-01 12:52:51 +08:00 1
维护两个版本太麻烦了，我 README 只有英文的，因为感觉想看我这项目的人，这点英文读下去应该没难度。
|
 |
90
andytao 2023-09-01 12:58:53 +08:00 1
中国人维护的项目强烈建议一定要有中文，有没有英文自己看着办，但一定要有中文，因为中文是我们的母语和根，不能丢了自己的根呀。
Github 是英语社区，它就没有提供多语言的规范和支持，说明啥？ 说明它期望甚至强迫我们写英文文档，丰富英文社区，可我们是华夏儿女，用的是中文汉字呀。咱们不能用自己水电和生命，单纯去丰富他人的社区，进而导致了我们的儿孙看不懂、学不会我们创造的东西。 |
|
91
ZeroDu 2023-09-01 13:02:46 +08:00
|
|
92
andytao 2023-09-01 13:05:42 +08:00
中国人维护的项目强烈建议一定要有中文，有没有英文自己看着办，但一定要有中文，因为中文是我们的母语和根，不能丢了自己的根呀。
Github 是英语社区，它就没有提供多语言的规范和支持，说明啥？ https://github.com/github/markup/issues/899 说明它期望甚至强迫我们写英文文档，丰富英文社区，可我们是华夏儿女，用的是中文汉字呀。咱们不能用自己水、电和生命，单纯去丰富他人的社区，进而导致了我们的儿孙看不懂、学不会我们创造的东西。 |
|
93
andytao 2023-09-01 13:15:01 +08:00
Github 是一个国际社区，它没有提供 README 的多语言规范指引和支持，说明它有一定的文化殖民倾向。
只要我你他的儿孙还是用中文，就应该优先用中文写 README ，这样他们就可以循着足迹找到我们的作品，了解我们曾经的过往，老外看不懂可以用翻译嘛，不用太考虑他们。 |
 |
94
wangmou 2023-09-01 13:28:14 +08:00
看受众。其实最烦的就是那些受众是国人，然后非要装逼写英文，外国人又用不到你那东西，英文写的也别别扭扭何必呢。。。
|
 |
95
dif 2023-09-01 14:38:36 +08:00 1
如果你主要针对国人，那就中文优先。
如果你野心大，要面向国际，那就英文优先。 |
|
96
andytao 2023-09-01 16:05:51 +08:00 1
如果软件或库很优秀，就算 README 用的是中文，老外会用翻译工具来学习使用它；
如果软件或库很低劣，就算 README 用的是英文，国内国外用户都不会有人来鸟它； README 用中文还是英文很关键吗？不是，那么用最省力的语言写 README 就好了。 |
|
97
EatMi OP @wangmou #94 兄弟，感觉你稍微有点偏激了，人家本来就是开源免费的东西，为爱发电，而且作为作者本人的东西，写什么也都无可厚非，没有必要这么说，平和一点嘛，可能也不是要装逼，可能就是想锻炼一下，或者往功利处讲，可能写英文更有利于他本人呢，比如找工作加分项等
 |
|
98
EatMi OP @andytao #96 对，你说的在理，但是项目初期的话，个人项目，可能还是稍微会有点影响的。但这也不是重点，更想和大家讨论的是主观层面的意愿和倾向
|
Select Language