2017 10 29 用中文命名API的意義和途徑

2022-05-07 13:03:10 字數 1052 閱讀 2183

"中文程式設計"知乎專欄原鏈

在前文對在**中使用中文命名的質疑與回應中闡述了在**中使用中文命名的益處. 此文將從軟體使用者的角度闡述對api中文化的意義並**實現途徑. 當然, 文中面向的使用者是以中文為母語的開發者.

首先請看乙個例項, 演示效果在此:

這個庫提供了一系列繪圖相關的api. 後者是筆者將這些api封裝成了中文之後的對應**.

此文的大前提是, 對以中文為母語的開發者, 中文介面版本的**更易理解.

api作為程式和程式之間交流的"語言", 在軟體生態圈中的重要性不言而喻. 擁有一套設計良好, 易於理解的api是大多數流行框架和庫共有的特徵. 當然, 絕大多數的api都是英文的. 導致中文使用者在學習和使用時就要更多地依賴文件和注釋.

中文api的命名更能被中文使用者接受. 它將直接降低使用者的學習門檻, 並降低維護成本. 當然, 第三方庫對中文字元的支援問題仍然會對這一實踐造成麻煩, 但個人認為在實踐中解決這些麻煩是降低軟體開發成本付出的代價, 而且解決的越早, 後人越能乘涼.

現狀是, 即使一些國人主創, 且幾乎完全面向國內使用者的框架, 也沒有中文的api. 這裡絕無指摘之意, 因為冰凍三尺非一日之寒, 更何況這些框架問世之時中文字元的支援程度也遠不如今日.

以在下淺見, 開發中文api的途徑包括:

如果能夠做到在內部**和api都使用中文命名, 當然是最理想的, 但個人認為api的命名是更關鍵的一部分. 中文的命名規範幾乎是空白, 這需要實踐和集體智慧型來填補.

封裝現有的英文api也許比較有爭議. 常見的一種觀點是"xx語言的核心庫, 先漢化給我看看". 這是乙個尋找切入點的問題. 乙個主流程式語言的核心庫, 往往經歷十數年甚至更長時間的積累, 介面不下萬個. 而一些特定領域的庫的api, 介面不過數十個. 領域受眾也是很重要的因素. 有興趣的請在跨界: 哪些中文非it領域會偏好中文api, 程式設計/指令碼語言?一起**.

2017 10 29 用中文命名API的意義和途徑

在前文對在 中使用中文命名的質疑與回應中闡述了在 中使用中文命名的益處.此文將從軟體使用者的角度闡述對api中文化的意義並 實現途徑.當然,文中面向的使用者是以中文為母語的開發者.首先請看乙個例項,演示效果在此 這個庫提供了一系列繪圖相關的api.後者是筆者將這些api封裝成了中文之後的對應 此文的...

用中文命名API的意義和途徑

在前文對在 中使用中文命名的質疑與回應中闡述了在 中使用中文命名的益處.此文將從軟體使用者的角度闡述對api中文化的意義並 實現途徑.當然,文中面向的使用者是以中文為母語的開發者.首先請看乙個例項,演示效果在此 這個庫提供了一系列繪圖相關的api.後者是筆者將這些api封裝成了中文之後的對應 此文的...

中文命名實體識別

命名實體識別是nlp裡一項很基礎的任務,就是從文字中識別出命名性指稱項,為關係抽取等任務做鋪墊。狹義上,是識別出人名 地名和組織機構名這三類命名實體 時間 貨幣名稱等構成規律明顯的實體型別可以用正則等方式識別 當然,在特定領域中,會相應地定義領域內的各種實體型別。1.中文文字不像英文有空格作為詞語的...