我是一名應(yīng)屆AI畢業(yè)生（大約2年），工作不多。創(chuàng)建基本的C＃編碼標(biāo)準(zhǔn)文檔（主要是因?yàn)槲沂窃摬块T的第一個(gè)“采用者”）已由我負(fù)責(zé)。我想我應(yīng)該解釋一下，我可能是最初級的軟件工程師，但是我很期待這個(gè)任務(wù)，因?yàn)槲蚁Ｍ铱赡苣軌蛏a(chǎn)出一半可用的東西。我已經(jīng)在Internet上進(jìn)行了相當(dāng)廣泛的搜索，并閱讀了有關(guān)編碼標(biāo)準(zhǔn)文檔應(yīng)包含/不應(yīng)包含的文章。這似乎是尋求任何建議的好地方。我意識到，我有可能為整個(gè)關(guān)于“最佳做事方式”的分歧打開大門。我既理解又尊重一個(gè)不可否認(rèn)的事實(shí)，即每個(gè)程序員都有解決每個(gè)任務(wù)的首選方法，因此，我不想寫任何過于pro腳的命令來扼殺個(gè)人才能，而是嘗試獲得一種通用的方法并達(dá)成共識標(biāo)準(zhǔn)（例如命名約定），以幫助使個(gè)人代碼更具可讀性。所以這里....有什么建議嗎？有沒有？
3 回答
不負(fù)相思意
TA貢獻(xiàn)1777條經(jīng)驗(yàn) 獲得超10個(gè)贊
具有諷刺意味的是，設(shè)置實(shí)際標(biāo)準(zhǔn)可能很容易。
我的第一個(gè)建議是從其他工程師那里獲得關(guān)于他們應(yīng)該涵蓋的內(nèi)容以及他們認(rèn)為重要的準(zhǔn)則的建議。實(shí)施任何類型的指南都需要一定程度的人員支持。如果您突然在文檔上放了一個(gè)文檔，該文檔指定了如何編寫代碼，那么無論您是最初級的還是高級的，您都會遇到阻力。
提出一組建議后，請將其發(fā)送給團(tuán)隊(duì)以征詢反饋并進(jìn)行審查。再一次，讓人們?nèi)σ愿啊?/p>
可能已經(jīng)采用了非正式的編碼實(shí)踐（例如，為成員變量加上前綴，駝峰函數(shù)名稱）。如果存在，并且大多數(shù)代碼都遵循它，那么它將需要形式化其使用。即使通常建議這樣做，采用相反的標(biāo)準(zhǔn)也會引起更多的痛苦。
還值得考慮重構(gòu)現(xiàn)有代碼以滿足新的編碼標(biāo)準(zhǔn)。這看起來似乎是在浪費(fèi)時(shí)間，但是擁有不符合標(biāo)準(zhǔn)的代碼可能會適得其反，因?yàn)槟鷮⒂龅礁鞣N風(fēng)格的混搭。人們是否在某個(gè)模塊中的代碼應(yīng)該遵循新標(biāo)準(zhǔn)還是遵循現(xiàn)有代碼風(fēng)格方面也陷入了困境。
翻閱古今
TA貢獻(xiàn)1780條經(jīng)驗(yàn) 獲得超5個(gè)贊
切勿使用MS（或適用于您的語言的Sun或...）編寫自己的編碼標(biāo)準(zhǔn)。線索在“標(biāo)準(zhǔn)”一詞中，如果每個(gè)組織都沒有決定自己編寫代碼，那么世界將更容易編碼。誰真的認(rèn)為每次您更改團(tuán)隊(duì)/項(xiàng)目/角色時(shí)學(xué)習(xí)一套新的“標(biāo)準(zhǔn)”都是對任何人的時(shí)間的良好利用。您應(yīng)該做的最大的事情就是總結(jié)關(guān)鍵點(diǎn)，但是我建議不要這樣做，因?yàn)殛P(guān)鍵的內(nèi)容因人而異。我想就編碼標(biāo)準(zhǔn)提出另外兩點(diǎn)
閉合足夠好-只要代碼足夠接近，更改代碼以遵循字母的編碼標(biāo)準(zhǔn)是浪費(fèi)時(shí)間。
如果要更改代碼，則不會遵循“本地編碼標(biāo)準(zhǔn)”來編寫代碼，即使新代碼看起來像周圍的代碼。
這兩點(diǎn)是我希望每個(gè)人都編寫看起來相同的代碼的現(xiàn)實(shí)。
- 3 回答
- 0 關(guān)注
- 340 瀏覽
添加回答
舉報(bào)
0/150
提交
取消