在前文對在**中使用中文命名的質疑與回應中闡述了在**中使用中文命名的益處. 此文將從軟體使用者的角度闡述對api中文化的意義並**實現途徑. 當然, 文中面向的使用者是以中文為母語的開發者.
首先請看乙個例項, 演示效果在此:
這個庫提供了一系列繪圖相關的api. 後者是筆者將這些api封裝成了中文之後的對應**.
此文的大前提是, 對以中文為母語的開發者, 中文介面版本的**更易理解.
api作為程式和程式之間交流的"語言", 在軟體生態圈中的重要性不言而喻. 擁有一套設計良好, 易於理解的api是大多數流行框架和庫共有的特徵. 當然, 絕大多數的api都是英文的. 導致中文使用者在學習和使用時就要更多地依賴文件和注釋.
中文api的命名更能被中文使用者接受. 它將直接降低使用者的學習門檻, 並降低維護成本. 當然, 第三方庫對中文字元的支援問題仍然會對這一實踐造成麻煩, 但個人認為在實踐中解決這些麻煩是降低軟體開發成本付出的代價, 而且解決的越早, 後人越能乘涼.
現狀是, 即使一些國人主創, 且幾乎完全面向國內使用者的框架, 也沒有中文的api. 這裡絕無指摘之意, 因為冰凍三尺非一日之寒, 更何況這些框架問世之時中文字元的支援程度也遠不如今日.
以在下淺見, 開發中文api的途徑包括:
如果能夠做到在內部**和api都使用中文命名, 當然是最理想的, 但個人認為api的命名是更關鍵的一部分. 中文的命名規範幾乎是空白, 這需要實踐和集體智慧型來填補.
封裝現有的英文api也許比較有爭議. 常見的一種觀點是"xx語言的核心庫, 先漢化給我看看". 這是乙個尋找切入點的問題. 乙個主流程式語言的核心庫, 往往經歷十數年甚至更長時間的積累, 介面不下萬個. 而一些特定領域的庫的api, 介面不過數十個. 領域受眾也是很重要的因素. 有興趣的請在跨界: 哪些中文非it領域會偏好中文api, 程式設計/指令碼語言?一起**.
2017 10 29 用中文命名API的意義和途徑
在前文對在 中使用中文命名的質疑與回應中闡述了在 中使用中文命名的益處.此文將從軟體使用者的角度闡述對api中文化的意義並 實現途徑.當然,文中面向的使用者是以中文為母語的開發者.首先請看乙個例項,演示效果在此 這個庫提供了一系列繪圖相關的api.後者是筆者將這些api封裝成了中文之後的對應 此文的...
2017 10 29 用中文命名API的意義和途徑
中文程式設計 知乎專欄原鏈 在前文對在 中使用中文命名的質疑與回應中闡述了在 中使用中文命名的益處.此文將從軟體使用者的角度闡述對api中文化的意義並 實現途徑.當然,文中面向的使用者是以中文為母語的開發者.首先請看乙個例項,演示效果在此 這個庫提供了一系列繪圖相關的api.後者是筆者將這些api封...
SQL 用中文的拼音和筆畫排序
城市按拼音排序 select chinesename from 表名 order by chinesename collate chinese prc cs as ks ws asc 城市按筆劃排序 select chinesename from 表名 order by chinesename co...