「英文」是不少人学写程式的一个关卡，而「命名」又是电脑科学最难的问题之一 。我正在整理几个最常见的「如何用英文命名程式里的某个东西？」的问题与答案 ，在此与各位分享目前整理好的第一个题目： * 如何命名「数量变数」？ * Count / Number / Quantity * 什麽时候该用哪个字？该怎麽用？ --- * Google 简报版: https://bit.ly/38OWoKf * Google 简报原始档: https://bit.ly/3elcZGT * Facebook 相簿版: https://bit.ly/3iNsgDO * GitHub 讨论区: https://bit.ly/321ResR --- 首先，可以试试看命名以下变数（文末有参考答案）： 1. 玩家(player)数量 2. 弹药(ammo)数量 3. 子弹(bullet)质量(mass) （以克(gram)计） 4. 生命值(hit points) 如果这对你来说没有难度，或许你会有兴趣到 GitHub 讨论区看看其它我正在整理 的题目: https://bit.ly/321ResR --- # 命名「数量变数」的方法 1. 辨认变数名词词性 * 不可数名词 * 可数生物 * 可数非生物 2. 对应单字及格式（见後文） * 可数生物、可数非生物： Count / Number * 不可数名词、可数非生物： Quantity --- # 不可数名词 ## 推荐格式 * 不可数名词 + In + 单位(复数) goldInKilograms 黄金（以公斤计） * 单位(复数) + Of + 不可数名词 kilogramsOfGold 黄金（以公斤计） ## 其它格式 * 不可数名词 + Amount ： goldAmount 黄金数量 * 不可数名词 + Quantity ： goldQuantity 黄金数量 * amountOf + 不可数名词 ： amountOfGold 黄金数量 * quantityOf + 不可数名词 ： quantityOfGold 黄金数量 这些格式无法清楚表达数量单位，其可读性在科学或金融计算上并不理想，但在其 它情景或许不是问题（例如，游戏设计）。 --- # 可数生物 ## 推荐格式 * 生物(单数) + Count studentCount 学生人数 尤其适合为「用来计数的变数」命名 * numberOf + 生物(复数) numberOfEmployees 员工人数 ## 常见问题 * 生物(单数) + Number 在语意上是「号码」的意思 studentNumber 学生号码 * countOf + 生物(复数) 在语法上通常不会这样写 --- # 可数非生物 ## 推荐格式 * 非生物(单数) + Count bookCount 书本数量 尤其适合为「用来计数的变数」命名 * 非生物(单数) + Quantity bookQuantity 书本数量 尤其适合用在「货物」上 * numberOf + 非生物(复数) numberOfBooks 书本数量 * quantityOf + 非生物(复数) quantityOfBooks 书本数量 尤其适合用在「货物」上 ## 常见问题 * 非生物(单数) + Number 在语意上是「号码」的意思 accountNumber 帐户号码 * countOf + 非生物(复数) 在语法上通常不会这样写 --- # 其它讨论 * 有的时候，程式可读性的确是 *相对地* 没那麽重要。 * 满足需求、解决问题、创造价值最重要。 * 提昇程式可读性的方法不止一种 * 要把程式码上下文脉络、使用情景、团队文化、产业领域也纳入考量。 --- 相对於「写作风格」（驼峰式大小写、蛇式／烤肉串式、等等），我想从另一个角 度，聚焦於「学会用英文表达想法」， 学会用英文提昇程式可读性。 我很想知道读者在写程式时，遇到了怎麽样的英文表达问题。 我目前有蒐集到一些题目，例如： * Count / Length / Size, 什麽时候该用哪个字？该怎麽用？ * Copy / Clone / Duplicate * Sum 与 Total 的差别 * Validate vs. Verify 很欢迎读者推文（或到 GitHub 讨论区 https://bit.ly/321ResR ）提出 * 问题 * 建议 * 感想 谢谢。 --- # 练习题 *参考* 答案 1. numberOfPlayers, playerCount 2. quantityOfAmmo, ammoQuantity 3. bulletMassInGrams 4. hitPoints --

※ 发信站: 批踢踢实业坊(ptt.cc), 来自: 136.56.13.184 (美国) ※ 文章网址: https://webptt.com/cn.aspx?n=bbs/Soft_Job/M.1594363672.A.7D0.html 谢谢各位的欣赏 :) 如果在程式写作上有任何与英文表达有关的问题，请让我知道 ，这会是「用英文提昇程式可读性」很棒的研究题材。 完全能理解，解决问题优先。 语言能做到优雅当然是好，但最重要的功能还是沟通（人与人的沟通、人与机器的 沟通）。 我开了 https://github.com/EngTW/English-for-Programmers/issues/8 来追踪 这个题目，谢谢 :) ※ 编辑: AmosYang (136.56.13.184 美国), 07/10/2020 15:56:07 XD ※ 编辑: AmosYang (136.56.13.184 美国), 07/10/2020 15:57:50 完全能理解，缩写、简写、更短的字、更简洁的写法，只要能解决问题，都是好的 。 我开了 https://github.com/EngTW/English-for-Programmers/issues/7 来追踪 这个题目，谢谢 :) 我开了 https://github.com/EngTW/English-for-Programmers/issues/7 来追踪 「缩写、简写」这个题目；谢谢提供这个题目 :) amount 整理在「不可数名词」的「其它格式」那段。 :) amount 本身当主词时，常用来描述金钱上的「总金额(total amount)」，我开了 https://github.com/EngTW/English-for-Programmers/issues/9 来追踪这个题目 ，谢谢 :) 我开了 https://github.com/EngTW/English-for-Programmers/issues/7 来追踪 「缩写、简写」这个题目；谢谢提供这个题目 :) 我开了 https://github.com/EngTW/English-for-Programmers/issues/10 来追踪 这个题目，谢谢 :) 我开了 https://github.com/EngTW/English-for-Programmers/issues/7 来追踪 「缩写、简写」这个题目；谢谢 :) 我开了 https://github.com/EngTW/English-for-Programmers/issues/8 来追踪 这个题目，谢谢 :) 我开了 https://github.com/EngTW/English-for-Programmers/issues/8 来追踪 这个题目，谢谢 :) 我开了 https://github.com/EngTW/English-for-Programmers/issues/7 来追踪 「缩写、简写」这个题目；谢谢 :) 我开了 https://github.com/EngTW/English-for-Programmers/issues/8 来追踪 这个题目，谢谢 :) 我开了 https://github.com/EngTW/English-for-Programmers/issues/11 来追踪 "metasyntactic variable" 这个题目，谢谢 :) ※ 编辑: AmosYang (136.56.13.184 美国), 07/11/2020 02:40:00 感谢各位的欣赏与提供题目 orz 如果我漏看了题目，请告诉我，谢谢 :) ※ 编辑: AmosYang (136.56.13.184 美国), 07/11/2020 02:44:32 感谢指点 orz ※ 编辑: AmosYang (136.56.13.184 美国), 07/11/2020 05:36:24 感谢各位的欣赏 :) 如果能想到「很难看懂、需要通灵」的命名案例，请让我知道；这可以帮助我把这 些资料整理得更完善，谢谢。 在这篇底下推文，或在 GitHub 或 Facebook 留言都可以 :) * GitHub: https://github.com/EngTW/English-for-Programmers/issues * Facebook: https://bit.ly/3iNsgDO ※ 编辑: AmosYang (136.56.13.184 美国), 07/12/2020 04:07:11 补上 Google 简报原始档: https://bit.ly/3elcZGT ※ 编辑: AmosYang (136.56.13.184 美国), 07/12/2020 12:44:21 谢谢 :) ※ 编辑: AmosYang (136.56.13.184 美国), 08/08/2020 03:09:46