怎麼樣提高 python 可讀性和質量

2021-10-10 19:35:02 字數 1024 閱讀 5385

以下是我的想法

首先給函式 / 類 / 方法取個好懂的名字 (我這點很失敗,英語太爛… 是不是應該加乙個學好英語)

當乙個差不多的操作出現了三次,不要繼續堆**,要抽象出來

我傾向於寫 fixme,todo, 寫檔案 / 函式的用途的注釋,在不是很好理解的**上面注釋作用,標明輸入和輸出都是什麼 (如果不是要修改維護你的**,沒人在乎你的演算法多 nb)

上面說的,請不要讓別人需要仔細研究你的**才明白是什麼意思… 我寫**很有壓力,因為我不想以後維護我**的人罵我.

不要炫技,請不要亂用函式式程式設計 / 閉包。我在乎的是效能和簡單粗暴的實現功能

多用標準庫的實現,如果不知道有這個功能實現前先 google.

多讀有名的專案,github 上面有很多。思考別人為什麼這樣用

…我們是封裝開源專案還是直接修改開源**給自己用

其實我這樣描述,比如有個專案因為歷史原因是乙個很早的版本。但是和其它新的版本元件有相容問題以及我們業務的特殊需要。我看了原始碼發現需要改動幾個地方. 問題改動後就需要自己維護這個專案,對於新部署的環境甚至其它版本我還繼續需要這個變動。還有一種聲音是 「你不能修改 xx 原始碼」, 你要在上面封裝出乙個新的東西, 也就是不直接呼叫 xx,而是在我的自己的專案對 xx 有了個封裝 yy,然後我們的呼叫 yy.

我覺得這個東西自己部署是乙個可行的方案,首先這個修改不是乙個 patch,不是主流的修改。只能算是我們業務的二次開發而已,封裝只是在掩耳盜鈴. 著讓我想起乙個問題:為什麼中國鮮有好的開源專案:中國人不缺好的 idea? 是因為中國人覺得這件事情做不了,是因為它們覺得別人實現的就是很牛比的, 自己改了就會有問題… 其實這是自卑… 首先是**就會有 bug,tornado/flask/requests 不還是在開發和解決問題嘛?bug 一直在只是你沒有發現和注意. 我覺得開源專案的**看懂了,了解了就可以修改… 沒什麼可擔心的… 我指的是角度。我覺得每個人學了一門語言看了某個專案的原始碼只要你有膽量, 你有乙個懷疑的善於發現和思考的心,那麼你都能貢獻你的**,做你的二次開發.

和本文相關:如果你沒有做過這件事,你怎麼可以說你會 python?

提高程式可讀性

在程式設計過程中注意提高程式的可讀性是良好的程式設計習慣,這使程式更易於理解,也更容易在以後進行修改和更正。同時也有助於我們理清自己的程式設計思路。為了避免步入 的wading,可讀性是必要的。不僅追求效率,也追求優雅,也即 乾淨利落的抽象 crisp abstraction 出自grady 物件導...

C 如何提高程式可讀性

程式的可讀性高是乙個程式設計師良好的程式設計習慣的體現。可讀性高可以讓程式設計師更好的理解冗長的 同時也更容易發現錯誤並且修改。不僅如此,在你請求別人對你的程式進行修改時,也能讓別人更好的進行修改工作。否找面對一坨坨的 段,恐怕沒人願意讀下去吧。所以這裡就提供幾個提高程式可讀性的技巧,如果你覺得自己...

元組中元組命名, 提高可讀性

xiwulin zhangsan 18,男 1234567 qq.com 1.利用下表讀取,可讀性非常低 print xiwulin 0 zhangsan print xiwulin 1 18 print xiwulin 2 男 2.定義數列值常量,類似於列舉型別 name,age,email ra...