干凈代碼是一組幾種代碼約定，它們共同創(chuàng)建了一種編寫代碼的新方式，使其更具可讀性、可維護(hù)性、可靠性和可預(yù)測性，從而提高效率并促進(jìn)團(tuán)隊(duì)合作.

干凈代碼的幾個(gè)原則之一是使用自描述和不言自明的名稱來命名變量，以避免歧義并編寫更干凈的代碼，一位偉大的作家 Zeno Rocha 在他的書中說道 高生產(chǎn)力的 14 個(gè)習(xí)慣開發(fā)人員?我們應(yīng)該始終編寫未來的自己即使在多年后也能理解的代碼。使用縮寫或縮寫命名變量可能會(huì)導(dǎo)致不同的解釋，特別是在項(xiàng)目參與程度不同的開發(fā)人員之間，這可能會(huì)導(dǎo)致未來的問題。

很常見的是，隨著代碼庫的增長并且其變量被擱置，將來需要重新訪問它，而糟糕的編寫將導(dǎo)致難以理解您的代碼。

不良變量的示例：

const date = new Date()
// Nome da varável é muito genêrica e n?o explica o que ela é

function getData(req, res) {}
// Nao descreve bem o dado que ela está requisitando 

好的變量的例子：

const currentDate = new Date()
// Nome mais explicativo sobre o que ela é e menos genêrico

function getUserGithubCategory(req, res) {} 
// Descreve melhor o dado que a fun??o está requisitando 

仍然按照編寫有意義的變量名稱的相同邏輯，我們遇到了另一個(gè)重要的點(diǎn)，即在編寫遵循相同編寫方向的布爾變量時(shí)，但我們必須使用另一個(gè)累積到前一個(gè)的小規(guī)則。

她說如下，我們應(yīng)該把布爾變量寫成某種可以回答是或否的問題，這是因?yàn)椴紶栕兞恐荒芙邮?true (是) 或 false (否) 和一個(gè)問題說出它們是否活躍有助于代碼閱讀。

不應(yīng)用規(guī)則的示例：

const ticketPark = user.ticketPark 

if (!ticketPark ) {
  throw new Error('O Marcos n?o possui um bilhete para entrar no parque!')
}

應(yīng)用規(guī)則的示例：

const hasUserTicket = user.hasTicket // o usuário tem o ticket ?

if (!hasUserTicket) { // se o usuário n?o tiver o ticket 
  throw new Error('O Marcos n?o possui um bilhete para entrar no parque!')
}

你是否同意我的觀點(diǎn)，當(dāng)使用這種命名布爾變量的模型時(shí)，如果用戶有票，他可以去乘車，而不是僅僅檢查公園票是否沒有，這并不會(huì)讓閱讀變得更簡單偽造的？ 使用這些類型確實(shí)可以提高第三方對(duì)您的代碼的理解，并幫助您避免歧義。

最后，我們還有一個(gè)與最后兩條規(guī)則相關(guān)的更簡單的規(guī)則，除了更好地編寫代碼之外，還可以使用變量在代碼中存儲(chǔ)“幻數(shù)”。但畢竟，代碼中的這些神奇數(shù)字是什么？ 通常，許多程序員在將業(yè)務(wù)規(guī)則應(yīng)用到他們的項(xiàng)目時(shí)，會(huì)使用各種數(shù)字來執(zhí)行代碼中的某些操作，然后將這些操作扔到代碼中，而不必解釋它們?yōu)槭裁丛谀抢铩?

充滿幻數(shù)的代碼示例：

const date = new Date()
// Nome da varável é muito genêrica e n?o explica o que ela é

你能明白代碼的用途嗎？

這些難以形容的數(shù)字很難吧？

你有沒有聽過這句話“我不知道為什么如果你刪除代碼會(huì)破壞”？它很好地表達(dá)了我在這里想說的，避免讓這些數(shù)字松散并且沒有解釋它們?yōu)槭裁丛谀抢?，如果不可能在變量中明確說明，請(qǐng)?jiān)诖a中進(jìn)行簡單的注釋。

看看這段代碼應(yīng)該怎么寫：

function getData(req, res) {}
// Nao descreve bem o dado que ela está requisitando 

現(xiàn)在好多了，對(duì)吧？

好處

采用清晰命名變量、避免幻數(shù)以及遵循干凈代碼原則等做法不僅可以提高代碼質(zhì)量，而且還可以更輕松地與其他開發(fā)人員協(xié)作并進(jìn)行長期維護(hù)。

請(qǐng)記?。壕帉懜蓛舻拇a并不是為了達(dá)到完美，而是為了讓代碼對(duì)每個(gè)使用它的人（包括將來的您）更易于訪問、理解和預(yù)測。

嘗試將這些規(guī)則應(yīng)用到您的下一個(gè)項(xiàng)目中并注意其中的差異！與同事或您的團(tuán)隊(duì)分享這些技巧，以創(chuàng)建一個(gè)更加高效的工作環(huán)境。畢竟，編寫良好的代碼是構(gòu)建高質(zhì)量軟件的第一步。

那么，從今天開始怎么樣？編寫您將來會(huì)自豪地閱讀的代碼！

以上是基于干凈代碼的變量命名的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！