[心得][英文] 一定要寫英文嗎？

[AmosYang (泛用人型編碼器)]

上次談了《如何命名「數量變數」？》，收到很多迴響，其中一個最常見的問題是
：「寫程式一定要用英文嗎？」今天就來談談這個題目。

* Google 簡報： https://bit.ly/32rtGy3
* Google 簡報原始檔： https://bit.ly/2DGDhXd
* Facebook 相簿： https://bit.ly/3fCF2mv

* GitHub 討論區： https://bit.ly/321ResR
* Twitter 討論串： https://bit.ly/2ZGtY2l

---
# 寫程式一定要用英文嗎？

有的時候，因為既有的產業行規、社群文化、團隊決策、技術限制，我們沒有選擇
；也就是所謂「人在江湖，身不由己」。

這裡討論的是「可以自己選擇」的情況，從以下兩個層面來思考。

* 技術
* 價值

---
# 技術

##  推薦「美式英文 + ASCII  字集」

因為歷史因素，英文是電腦科學的通用語，累積了極大的智慧資產，是故，以「相
容性」為考量，

* 在程式碼層級，使用 ASCII  字碼來命名變數、方法、類別、等等。
* 在使用各種工具時，使用 ASCII  字碼命名檔案、參數
* 現代鍵盤與字型罕有不支援 ASCII  字碼的。

「美式英文 + ASCII  字集」是個「低成本、高效益」的選擇。

## 案例討論

* 美式英文 與 英式英文 有些微拼字差異，例如

  * Color / Colour
  * Center / Centre
  * Serialize / Serialise

  當前函式庫、工具鏈，大多以美式英文為主。

* UNICODE 有它的好處，但也有它麻煩的地方，

  (PTT 對 Unicode 的支援不完整，請到 Google 簡報原始檔看這段：
  https://bit.ly/2DGDhXd )

  例如

  * U+03B1 / U+237A 看起來很相似

  * U+00C1 / U+0041 U+0301  顯示出來是同一個字，但是是不一樣的字元

  * 有些語言需要用到完整的拉丁字集才能精準表達意思。

  後面會討論「在程式碼中使用 Unicode 」的案例。

---
# 價值

程式作品的價值主要來自於「滿足需求，解決問題」，而不是「寫程式時用英文」
。

這 *不是* 在否定「寫程式時用英文 / 與世界潮流接軌 / 讓維護程式的人好做事
」這件事。

若能把英文學好，能流利地寫 commit 訊息、寫註解、寫文件、與洋鄉民交流、開
拓職涯，當然是好事。

這裡我們思考的是「成本與效益的平衡」，也就是說，如果目前英文還沒有那麼好
，怎麼辦？

也就是「寫程式一定要用英文嗎？」

我的主張是：

* 「滿足需求，解決問題」 > 「寫程式時用英文」
* 「正確 + 清楚 + 簡潔的資訊」 > 「模糊的資訊」
* 「正確 + 清楚 + 簡潔的非英文資訊」 > 「模糊的英文資訊」

也就是說，當你的程式作品先創造了價值，之後才會有人來想了解它。（也有可能
是兩週後的你自己回來看這程式 XD ）。

而「正確 + 清楚 + 簡潔的非英文資訊」會比「模糊的英文資訊」對它更有幫助。

它可以用機器翻譯「正確 + 清楚 + 簡潔的非英文資訊」，它可以找朋友翻譯。

但如果是「模糊的英文資訊」，那它就只能去通靈擲笅了。

##  錯誤訊息 > 文件 > 註解

撰寫「正確 + 清楚 + 簡潔的 (英文 / 非英文) 資訊」 也需要成本，我會依以下
順序來投資：

1. 錯誤訊息
2. 文件
3. 程式碼註解

我的想法是，「想用工具解決問題的人」會比「想了解工具構造的人」多。

或著說，在一個人對某工具的構造有興趣前，它要先覺得這工具很好用。

是故，我會先投資在程式的「錯誤訊息、警告、參數資訊」上，先幫助使用者解決
它的問題。

這些資訊、訊息通常也較短，不管是寫母語還是寫英文，比較容易做到「正確 +
清楚 + 簡潔」。

##  文化、產業、地區特有術語

與其硬翻而失真（最後從母語、英文兩邊都看不懂），可以考慮音譯、直譯，並加
上註解。

---
# Unicode

  (PTT 對 Unicode 的支援不完整，請到 Google 簡報原始檔看這段：
  https://bit.ly/2DGDhXd )

ASCII 是 1960 年代的東西，就方法、類別命名來說，還是推薦
「美式英文 + ASCII  字集」；但就小塊的程式碼而言，若適當使用 Unicode, 或
許可以增進程式碼的可讀性。

## Emoji

能這麼做，不代表該這麼做 XD

## 希臘字母 / subscript / superscript

數學、科學計算式常用到希臘字母、 subscript, superscript 。

相對於

* pi
* deltaT
* F_0
* F_n_1

這樣的傳統 ASCII  寫法， Unicode  提供了另一種可能性。

---
# 寫程式一定要用英文嗎？

就長遠來說，能多學、多練習、加強英文能力當然是好事。

但在英文能力還不到位時，為了滿足眼前的需求，不管是台式英文、漢語拼音、日
文拼音、用中文寫 commit 訊息、寫文件、寫註解，都是成本與效益的取捨。

希望這篇文有提供讀者一些思考的方向，來檢視每個人自己的取捨選擇策略。

有任何程式設計、軟體工程相關的英文問題，都很歡迎到《程式英文》 GitHub 討
論區 https://bit.ly/321ResR 留言；這可以幫助我把這知識庫整理得更完善。

謝謝 :)

--
※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 136.56.13.184 (美國)
※ 文章網址: https://www.ptt.cc/bbs/Soft_Job/M.1594976222.A.175.html
推 alihue: 推推
推 tw11509: 推推
推 bill0205: push
推 CaptPlanet: U質
推 lazyfirst: 推推
推 jobintan: Nice, dude.
謝謝 :)

接下來我打算整理這個題目：

* 「種類(type, kind, sort, class, category, classification)」該用哪個字？
* https://github.com/EngTW/English-for-Programmers/issues/13

如果有任何感想、問題、建議，請讓我知道 :)
※ 編輯: AmosYang (136.56.13.184 美國), 07/18/2020 13:04:30