React Academy · Pelajaran

Struktur Folder dan Konvensyen Penamaan

Susun projek React dengan folder berasaskan ciri dan nama fail yang jelas.

Pelajaran 4 daripada 413 langkah

Struktur Folder dan Konvensyen Penamaan ialah pelajaran React Academy percuma di CoddyKit. Ini ialah pelajaran 4 daripada 4. Anda boleh membaca keseluruhan pelajaran di bawah secara percuma — kemudian berlatih secara praktikal dalam pelayar menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran React Academy, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus React Academy merangkumi sejumlah 4 pelajaran.

Selamat Datang

Dalam pelajaran ini, anda akan meneroka struktur direktori biasa untuk projek React, mempelajari konvensyen penamaan bagi fail dan komponen, serta memahami cara menyusun kod apabila projek berkembang.

Struktur Lalai

Projek Vite + React minimum mempunyai `src/App.jsx` dan `src/main.jsx`. Ini memadai untuk demo kecil tetapi tidak dapat diskalakan. Apabila anda menambah ciri, cipta folder khusus untuk memastikan kod berkaitan kekal bersama.
src/
  main.jsx
  App.jsx
  index.css

Struktur Berdasarkan Ciri

Kumpulkan fail mengikut ciri, bukannya mengikut jenis. Setiap folder ciri mengandungi komponen, gaya, ujian dan fungsi pembantu. Ini memudahkan anda menambah atau memadam keseluruhan ciri sekali gus.
src/
  features/
    auth/
      LoginForm.jsx
      LoginForm.test.jsx
      useLogin.js
    dashboard/
      Dashboard.jsx
      useDashboardData.js
  components/     <- shared UI only
  hooks/          <- shared hooks
  lib/            <- utilities

Penamaan Fail Komponen

Namakan fail komponen menggunakan **PascalCase** agar sepadan dengan nama komponen: `UserCard.jsx`, `NavigationBar.jsx`. Satu komponen bagi setiap fail ialah amalan standard. Penggunaan `.jsx` (atau `.tsx`) memberitahu penyunting bahawa fail tersebut mengandungi JSX.

Penamaan Fail Bukan Komponen

Cangkuk, utiliti dan pemalar menggunakan **camelCase**: `useAuth.js`, `formatDate.js`, `apiClient.js`. Fail ujian mencerminkan sumbernya dengan `.test` atau `.spec`: `useAuth.test.js`.

Fail Indeks untuk Import yang Kemas

Menambahkan `index.js` pada folder membolehkan anda mengimport daripada laluan folder dan bukannya laluan fail penuh. Kekalkan fail indeks sebagai eksport semula sahaja — tanpa logik.
// src/features/auth/index.js
export { LoginForm } from './LoginForm';
export { useLogin } from './useLogin';

// Consumer
import { LoginForm } from '@/features/auth';

Import Mutlak dengan Alias Laluan

Konfigurasikan alias `@/` yang menunjuk ke `src/` dalam `vite.config.js` dan `tsconfig.json`. Ini mengelakkan laluan relatif yang rapuh seperti `../../../../components/Button`.
// vite.config.js
resolve: {
  alias: { '@': path.resolve(__dirname, 'src') }
}

Komponen Dikongsi berbanding Komponen Ciri

Letakkan komponen yang digunakan dalam satu ciri sahaja di dalam folder ciri tersebut. Pindahkan komponen ke `src/components/` hanya apabila dua atau lebih ciri memerlukannya. Elakkan pengekstrakan terlalu awal.

Fail Pemalar & Konfigurasi

Simpan rentetan ajaib, URL asas API dan pembalut pemboleh ubah persekitaran dalam `src/lib/constants.js` atau `src/config.js`. Jangan sesekali menyebarkan rentetan `process.env.VITE_API_URL` merentas banyak fail.
// src/config.js
export const API_BASE = import.meta.env.VITE_API_URL;

Jenis & Antara Muka (TypeScript)

Dalam projek TypeScript, letakkan jenis bersama ciri atau komponen yang menggunakannya. Untuk jenis dikongsi yang digunakan merentas banyak ciri, cipta `src/types/` dengan satu fail bagi setiap kawasan domain.

Semakan Pantas

Apakah kelebihan utama struktur folder berdasarkan ciri berbanding struktur berdasarkan jenis?

Imbas Kembali

Gunakan folder berdasarkan ciri, **PascalCase** untuk fail komponen, **camelCase** untuk cangkuk dan utiliti, eksport semula `index.js` untuk import yang kemas, serta alias laluan seperti @/ untuk menghapuskan laluan relatif yang panjang.

Kursus Selesai

Tahniah! Anda telah menamatkan **Mod Ketat React & Amalan Terbaik**. Kini anda memahami tingkah laku StrictMode, cara menulis fungsi pemaparan tulen, penggunaan kekunci dan rujukan yang betul, serta struktur folder yang boleh diskalakan.
Percuma untuk bermula

Pelajari React dengan tutor kecerdasan buatan — percuma

Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.

Kursus
88
Pelajaran
324

Soalan Lazim

Adakah pelajaran “Struktur Folder dan Konvensyen Penamaan” percuma?

Ya — teks penuh “Struktur Folder dan Konvensyen Penamaan” boleh dibaca secara percuma di web ini. Untuk berlatih secara interaktif menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7, serta membuka kunci baki kursus React Academy, tingkat taraf kepada CoddyKit PRO. Kursus React Academy merangkumi sejumlah 4 pelajaran.

Apakah yang akan saya pelajari dalam “Struktur Folder dan Konvensyen Penamaan”?

Susun projek React dengan folder berasaskan ciri dan nama fail yang jelas. Anda berlatih React Academy menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.

Adakah saya memerlukan pengalaman untuk memulakan React Academy?

Tiada pengalaman terdahulu diperlukan. Pembelajaran React Academy di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 4 daripada 4.

Berapa lamakah pelajaran “Struktur Folder dan Konvensyen Penamaan” diambil?

Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.

Bolehkah saya menulis dan menjalankan kod dalam pelajaran React Academy ini?

Ya. Setiap pelajaran React Academy menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.

Semua pelajaran dalam kursus ini

  1. Fungsi StrictMode
  2. Komponen Tulen dan Mengelakkan Kesan Sampingan dalam Paparan
  3. Amalan Terbaik Kunci dan Ref
  4. Struktur Folder dan Konvensyen Penamaan
← Kembali ke React Academy