Jadi Imperatif!!  TL;DR: Fungsi dengan nama yang tidak jelas menyembunyikan niat dan mengelirukan pembaca. Gunakan nama deskriptif, berorientasikan tindakan.  Masalah  Tujuan fungsi yang tidak jelas  Peningkatan beban kognitif  Konteks yang mengelirukan  Kebolehbacaan berkurangan  Kerjasama yang sukar  Fungsi tersembunyi  Penyelesaian  Gunakan kata kerja berorientasikan tindakan  Jadikan   sebagai deskriptif nama  Mencerminkan tujuan fungsi  Elakkan istilah generik  Menyediakan konteks yang bermakna  Nyatakan tanggungjawab tunggal dengan jelas  Padankan tindakan dengan hasil  Pemfaktoran semula   https://hackernoon.com/improving-the-code-one-line-at-a-time  Konteks  Fungsi yang dinamakan dengan istilah generik memaksa pembaca untuk menyelami pelaksanaan untuk memahami tingkah laku mereka.  Ini membuang masa dan meningkatkan peluang kesilapan.    menjadi lebih kritikal apabila bekerja dengan fungsi kendiri, di mana nama kelas tidak memberikan konteks tambahan. Penamaan  Isu ini secara langsung berkaitan dengan   . prinsip Beritahu, Jangan Tanya  Daripada mendedahkan tingkah laku samar-samar yang memaksa pemanggil untuk membuat kesimpulan kefungsian, nama penting menyampaikan tindakan yang tepat, membimbing pembaca tanpa perlu memeriksa kod.  Apabila anda menamakan fungsi secara deskriptif, anda menghapuskan tekaan yang tidak perlu dan selaras dengan prinsip ini.  Kod Contoh  salah   public String dateFormatting(Date date) { return new SimpleDateFormat("yyyy-MM-dd").format(date); } public void load() { System.out.println("Loading..."); }  Betul   public String formatDate(Date date) { return new SimpleDateFormat("yyyy-MM-dd").format(date); } public void loadUserPreferences() { System.out.println("Loading user preferences..."); }  Pengesanan    Manual [x]  Anda boleh mengesan bau ini dengan menyemak nama fungsi yang menggunakan istilah yang tidak jelas seperti   ,   ,   ,   , dsb. do run process load  Linter automatik boleh membenderakan corak ini atau menyerlahkan fungsi dengan nama yang terlalu generik.  Tag  Penamaan  Tahap    Pemula [x]  Mengapa Bijection Itu Penting  Nama fungsi hendaklah mencipta   yang jelas antara nama dan fungsinya. surat-menyurat satu dengan satu  Pemecahan   ini memaksa pembangun untuk memeriksa butiran kod untuk konteks, memperlahankan penyahpepijatan, ulasan dan sambungan. Bijection  Penjanaan AI  Alat AI kadangkala menjana nama fungsi generik tanpa memahami domain anda.  Apabila menggunakan AI, nyatakan bahawa nama fungsi mestilah deskriptif dan berorientasikan tindakan.  Pengesanan AI  Model AI boleh membantu mengesan nama samar-samar dengan membandingkan tandatangan fungsi dengan amalan terbaik penamaan yang telah ditetapkan.  Menggabungkan AI dengan semakan kod manual menghasilkan hasil yang terbaik.  Cuba Mereka!   Ingat: AI Assistants melakukan banyak kesilapan  Tanpa Arahan Yang Betul  Dengan Arahan Tertentu   SembangGPT   SembangGPT   Claude   Claude   Kebingungan   Kebingungan   Copilot   Copilot   Gemini   Gemini  Kesimpulan  Nama fungsi bukan sekadar label; mereka adalah kontrak dengan pembaca.    memecahkan kontrak ini dan membawa kepada kekeliruan. Nama yang samar-samar  Nama deskriptif, berorientasikan tindakan memudahkan komunikasi dan menjadikan kod anda lebih mudah untuk dikekalkan dan dilanjutkan.  perhubungan   https://hackernoon.com/how-to-find-the-stinky-parts-of-your-code-part-vii-8dk31x0?embedable=true https://hackernoon.com/how-to-find-the-stinky-parts-of-your-code-part-xxxi?embedable=true   https://hackernoon.com/how-to-find-the-stinky-parts-of-your-code-part-viii-8mn3352?embedable=true https://hackernoon.com/how-to-find-the-stinky-parts-of-your-code-part-xxxv?embedable=true  Lihat juga   https://hackernoon.com/what-exactly-is-a-name-the-quest-part-i-fmw3udc?embedable=true   https://hackernoon.com/what-exactly-is-a-name-rehab-part-ii-4st3uph?embedable=true  Penafian  Bau Kod adalah   saya. pendapat  Kredit  Foto oleh   di  britishlibrary Unsplash  Nama fungsi mestilah kata kerja atau frasa kata kerja, dan ia perlu bermakna   Robert C. Martin   https://hackernoon.com/400-thought-provoking-software-engineering-quotes?embedable=true  Artikel ini adalah sebahagian daripada Siri CodeSmell.   https://hackernoon.com/how-to-find-the-stinky-parts-of-your-code-part-i-xqz3evd?embedable=true

This story contains new, firsthand information uncovered by the writer.

Winner of Noonies 2020 for the award Hacker Noon Contributor of the Year - REFACTORING.

Bau Kod 285 - Cara Membetulkan Fungsi Bukan Imperatif

About Author

KOMEN

GANTUNG TANDA

ARTIKEL INI DIBENTANGKAN DALAM

Related Stories

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps