風格指南
這是Vue特定程式碼的官方風格指南。如果你在專案中使用Vue,它是一個很好的參考,可以避免錯誤、無謂的爭論和反模式。然而,我們不認為任何風格指南都適合所有團隊或專案,所以鼓勵基於以往經驗、周邊技術棧和個人價值觀進行有意識的偏離。
就大部分而言,我們也避免了一般JavaScript或HTML的建議。我們不介意你是否使用分號或尾隨逗號。我們不介意你的HTML在屬性值中是否使用單引號或雙引號。然而,某些例外將存在,因為我們發現Vue上下文中某個特定模式是有幫助的。
最後,我們將規則分為四個類別
規則類別
優先順序A:基本(錯誤預防)
這些規則有助於預防錯誤,所以不惜一切代價學習和遵守它們。雖然可能存在例外,但這些例外應該非常罕見,並且只有那些對JavaScript和Vue都有專家知識的人才能做出。
優先順序B:強烈推薦
這些規則在大多數專案中被發現可以改善可讀性和/或開發者體驗。即使違反這些規則,程式碼仍然可以執行,但違規應該很少,並且有很好的理由。
優先順序C:推薦
當存在多個同等好的選項時,可以選擇任意一個以確保一致性。在這些規則中,我們描述了每個可接受的選項,並建議了一個預設選擇。這意味著你可以在自己的程式碼庫中自由地做出不同的選擇,只要你保持一致並有合理的理由。但請務必有合理的理由!透過適應社群標準,你將
- 訓練你的大腦,以便更容易地解析你遇到的社群程式碼的大部分內容
- 能夠複製並貼上大多數社群程式碼示例,無需修改
- 通常發現新員工已經習慣了你的首選編碼風格,至少在Vue方面是這樣
優先順序D:謹慎使用
Vue的一些功能是為了適應罕見的邊緣情況或從舊程式碼庫中更平滑地遷移。然而,過度使用它們可能會使你的程式碼更難以維護,甚至可能成為錯誤的原因。這些規則突出了潛在的有風險的功能,描述了何時以及為什麼應該避免它們。