GitHub Untuk Pemula: Cara Simpan Kod, Urus Versi Dan Bina Portfolio Projek

Apabila mula belajar coding, ramai orang menyimpan projek dengan cara yang sama seperti menyimpan dokumen biasa. Mereka mencipta folder baharu, menyalin fail lama dan memberikan nama seperti projek-finalprojek-final-baruprojek-final-betul atau projek-final-terakhir.

Kaedah ini mungkin masih boleh digunakan untuk projek kecil. Namun, apabila bilangan fail bertambah atau beberapa orang mula bekerja pada projek yang sama, keadaan mudah menjadi kelam-kabut.

Anda mungkin tidak tahu fail mana yang paling terkini. Anda juga mungkin terlupa perubahan yang dibuat semalam, override kod yang sebenarnya masih diperlukan atau merosakkan fungsi yang sebelum ini berjalan dengan baik.

Di sinilah Git dan GitHub menjadi berguna.

GitHub bukan sekadar website untuk programmer mempamerkan kod. Ia boleh digunakan untuk:

  • menyimpan projek;
  • merekod sejarah perubahan;
  • menguji fungsi baharu tanpa merosakkan versi utama;
  • bekerjasama dengan ahli pasukan;
  • menyemak kod;
  • mengurus tugasan;
  • membina portfolio kerjaya;
  • menyumbang kepada projek sumber terbuka;
  • mengawal perubahan yang dihasilkan oleh AI coding tool.

Tutorial rasmi GitHub sendiri memperkenalkan repository, branch, commit dan pull request sebagai asas penting untuk memahami cara kerja platform tersebut.

Artikel ini akan menerangkan cara menggunakan GitHub dari peringkat asas sehingga anda mempunyai repository yang kemas dan sesuai ditunjukkan kepada majikan, pelanggan atau rakan kolaborasi.

Apa Itu GitHub?

GitHub ialah platform dalam talian untuk menyimpan, mengurus dan bekerjasama dalam projek yang menggunakan sistem kawalan versi Git.

Dalam bahasa mudah, GitHub membantu anda menyimpan bukan sahaja fail semasa, tetapi juga sejarah perubahan terhadap fail tersebut.

Sebagai contoh, anda sedang membina sebuah website. Pada minggu pertama, anda menyiapkan halaman utama. Pada minggu kedua, anda menambah borang pendaftaran. Pada minggu ketiga, anda mengubah menu dan reka bentuk mudah alih.

Dengan penyimpanan biasa, anda mungkin hanya mempunyai versi terkini. Dengan Git, setiap perubahan penting boleh direkodkan sebagai commit. Anda boleh melihat semula apa yang berubah, bila perubahan dibuat dan siapa yang membuatnya.

GitHub kemudian menyediakan tempat dalam talian untuk menyimpan repository Git tersebut serta menambah fungsi seperti pull request, issue, perbincangan, semakan kod dan automasi.

Adakah GitHub Hanya Untuk Menyimpan Kod?

Tidak.

Walaupun GitHub banyak digunakan untuk pembangunan perisian, ia juga sesuai untuk menyimpan fail berasaskan teks seperti:

  • dokumentasi teknikal;
  • nota projek;
  • fail Markdown;
  • skrip automasi;
  • fail konfigurasi;
  • template;
  • dataset bersaiz kecil;
  • notebook analisis data;
  • kandungan website statik;
  • dokumentasi API;
  • rekod perubahan produk.

Namun, GitHub bukan pengganti sempurna kepada Google Drive atau Dropbox.

Git berfungsi paling baik untuk fail teks kerana perubahan antara dua versi boleh dibandingkan dengan jelas. Ia kurang sesuai untuk koleksi video, foto resolusi tinggi, fail reka bentuk yang besar atau fail binari yang sentiasa berubah.

Gunakan GitHub untuk mengurus struktur, kod dan dokumentasi projek. Gunakan storan awan biasa untuk fail media berat jika tiada keperluan kawalan versi khusus.

github untuk pemula proses ebook BukuLab Malaysia

Apakah Perbezaan Antara Git Dan GitHub?

Git dan GitHub bukan perkara yang sama.

Apa Itu Git?

Git ialah sistem kawalan versi yang dipasang pada komputer. Ia merekod perubahan terhadap fail projek.

Git boleh digunakan tanpa internet. Anda masih boleh membuat branch, commit dan melihat sejarah projek secara lokal.

Apa Itu GitHub?

GitHub ialah platform dalam talian yang menjadi tempat repository Git disimpan dan dikongsi.

GitHub menambah fungsi kolaborasi seperti:

  • pull request;
  • semakan kod;
  • issue;
  • pengurusan akses;
  • perbincangan;
  • dokumentasi;
  • automasi melalui GitHub Actions.

Perbandingan Git Dan GitHub

PerkaraGitGitHub
JenisSistem kawalan versiPlatform hosting dan kolaborasi
LokasiDipasang pada komputerDigunakan melalui internet
InternetTidak sentiasa diperlukanDiperlukan untuk synchronize repository
Fungsi utamaMerekod perubahan failMenyimpan dan berkongsi repository
KolaborasiTerhad secara lokalPull request, issue dan semakan kod
Contoh tindakanCommit, branch, mergePush, pull request, review dan issue

Analogi mudahnya, Git ialah sistem yang merekod sejarah setiap versi projek. GitHub pula ialah tempat repository itu disimpan, dipamerkan dan dikendalikan bersama orang lain.

Mengapa Pemula Perlu Belajar GitHub?

1. Mengelakkan Fail Projek Berselerak

GitHub mengurangkan keperluan menyimpan terlalu banyak salinan projek dengan nama yang mengelirukan.

Anda tidak perlu lagi bergantung pada folder seperti:

  • website-lama
  • website-baru
  • website-final
  • website-final-v2
  • website-final-betul

Sejarah commit memberikan rekod yang lebih tersusun.

2. Memulihkan Versi Sebelumnya

Kesilapan coding memang akan berlaku.

Anda mungkin memadam fungsi penting, mengubah fail yang salah atau menerima cadangan AI yang merosakkan projek. Dengan Git, anda boleh membandingkan perubahan dan kembali kepada keadaan sebelumnya.

Walau bagaimanapun, Git bukan butang ajaib yang membetulkan semua masalah. Anda masih perlu membuat commit secara konsisten dan memahami perubahan yang dilakukan.

3. Bekerjasama Dengan Pasukan

Branch membolehkan beberapa orang bekerja pada fungsi berbeza tanpa terus mengganggu versi utama.

Pull request pula menyediakan ruang untuk:

  • menerangkan perubahan;
  • meminta semakan;
  • membincangkan masalah;
  • menjalankan ujian;
  • meluluskan atau menolak perubahan.

GitHub Flow secara asasnya melibatkan penciptaan branch, membuat perubahan, membuka pull request, menjalankan semakan dan menggabungkan perubahan ke branch utama selepas diluluskan.

4. Membina Portfolio Kerjaya

Resume boleh menyatakan bahawa anda tahu JavaScript, Python, React atau WordPress. Namun, repository GitHub boleh menunjukkan bukti.

Majikan atau pelanggan boleh menilai:

  • projek yang pernah dibina;
  • cara anda menyusun fail;
  • kualiti dokumentasi;
  • cara anda menulis commit;
  • proses menyelesaikan masalah;
  • konsistensi pembangunan;
  • tahap pemahaman terhadap teknologi.

5. Menyumbang Kepada Open Source

Banyak projek sumber terbuka dihoskan di GitHub.

Anda boleh belajar dengan membaca kod, melaporkan masalah, membaiki dokumentasi atau menghantar perubahan melalui pull request.

Sumbangan kecil yang berkualiti lebih bernilai daripada membuat banyak commit kosong semata-mata untuk memenuhi contribution graph.

6. Mengawal Perubahan Daripada AI

AI coding tool boleh menghasilkan perubahan dengan pantas, tetapi pantas tidak bermaksud betul.

GitHub membantu anda:

  1. mencipta branch sebelum AI mengubah projek;
  2. melihat fail yang telah diubah;
  3. membandingkan kod lama dan baharu;
  4. menjalankan ujian;
  5. menolak perubahan yang bermasalah;
  6. menggabungkan hanya perubahan yang telah disemak.

Siapa Yang Sesuai Menggunakan GitHub?

GitHub berguna kepada lebih ramai pengguna daripada yang biasa disangka, termasuk:

  • pelajar teknologi maklumat;
  • pelajar sains komputer;
  • individu yang baru belajar coding;
  • web developer;
  • WordPress developer;
  • pembangun aplikasi;
  • data analyst;
  • data scientist;
  • freelancer;
  • pereka produk digital;
  • pengguna Codex atau AI coding agent;
  • pemilik SME yang mengurus developer;
  • pencari kerja dalam bidang teknologi.

Pemilik perniagaan tidak semestinya perlu menjadi programmer. Namun, memahami asas repository, branch dan pull request membantu mereka memantau projek yang dibina oleh developer luar.

Istilah Penting GitHub Yang Perlu Difahami

Repository

Repository atau sering disebut sebagai repo ialah ruang utama yang mengandungi fail dan sejarah sesuatu projek.

Satu repository biasanya mewakili satu projek, contohnya:

  • website syarikat;
  • plugin WordPress;
  • aplikasi mudah alih;
  • dashboard jualan;
  • skrip automasi;
  • projek analisis data.

Commit

Commit ialah rekod perubahan pada satu titik tertentu.

Dokumentasi GitHub menerangkan commit seperti gambaran atau snapshot fail projek pada sesuatu masa.

Commit yang baik sepatutnya mempunyai mesej jelas seperti:

  • Tambah borang pendaftaran pengguna
  • Baiki menu pada paparan mudah alih
  • Betulkan formula jumlah jualan
  • Kemas kini arahan pemasangan

Elakkan mesej yang terlalu umum seperti updatefixnew atau changes.

Branch

Branch ialah laluan kerja berasingan dalam repository.

Ia membolehkan anda mengubah projek tanpa terus mengganggu branch utama. Selepas perubahan selesai dan diuji, branch tersebut boleh digabungkan kembali melalui proses merge.

Main Branch

Main ialah nama lazim bagi branch utama.

Branch ini biasanya mengandungi versi projek yang dianggap stabil atau sedia digunakan. Pemula sering melakukan semua kerja terus pada main. Itu mungkin mencukupi untuk latihan kecil, tetapi tabiat tersebut berisiko apabila projek semakin besar.

Clone

Clone bermaksud menyalin repository dari GitHub ke komputer.

Selepas clone, anda mempunyai salinan lokal yang boleh diedit melalui code editor seperti Visual Studio Code.

Push

Push bermaksud menghantar commit dari komputer anda ke repository dalam GitHub.

Commit yang hanya dibuat pada komputer belum semestinya berada di GitHub. Anda perlu melakukan push untuk synchronize-kannya.

Pull

Pull bermaksud mengambil perubahan terbaru dari GitHub ke komputer.

Lakukan pull sebelum memulakan kerja, terutama apabila beberapa orang mengubah repository yang sama.

Fork

Fork ialah salinan repository pengguna lain yang dimasukkan ke akaun GitHub anda.

Fork biasanya digunakan apabila anda mahu mencuba perubahan atau menyumbang kepada projek yang tidak anda miliki.

Merge

Merge ialah proses menggabungkan perubahan dari satu branch ke branch lain.

Sebagai contoh, branch feature-login boleh digabungkan ke main selepas fungsi log masuk diuji.

Pull Request

Pull request ialah cadangan rasmi untuk menggabungkan perubahan.

Ia juga menjadi ruang semakan. Ahli pasukan boleh membaca penerangan, melihat perbezaan kod, memberi komen dan meminta pembetulan.

Issue

Issue digunakan untuk merekod:

  • bug;
  • cadangan fungsi;
  • tugasan;
  • pertanyaan;
  • perbincangan teknikal.

Issue yang baik menerangkan masalah dengan cukup jelas supaya orang lain boleh memahami dan mengujinya.

README

README ialah fail penerangan utama repository. Ia biasanya merupakan antara kandungan pertama yang dilihat oleh pelawat.

Menurut dokumentasi GitHub, README lazimnya menerangkan fungsi projek, sebab projek berguna, cara bermula, tempat mendapatkan bantuan serta pihak yang menyelenggarakannya.

github untuk pemula istilah ebook BukuLab Malaysia

Cara Membuka Akaun GitHub

1. Pilih Username Yang Profesional

Username anda boleh dilihat oleh majikan, pelanggan dan komuniti.

Pilih nama yang:

  • mudah dibaca;
  • tidak terlalu panjang;
  • tidak memalukan;
  • sesuai digunakan dalam resume;
  • hampir dengan nama sebenar atau jenama profesional.

2. Lengkapkan Profil

Tambahkan:

  • gambar profil yang sesuai;
  • bio ringkas;
  • bidang kemahiran;
  • lokasi jika relevan;
  • pautan website;
  • pautan LinkedIn atau portfolio.

Contoh bio:

WordPress developer dan data analyst dari Malaysia. Membina dashboard, plugin dan automasi untuk SME.

3. Aktifkan Pengesahan Dua Faktor

Pengesahan dua faktor atau 2FA menambah satu lagi lapisan keselamatan selain kata laluan. GitHub memerlukan pengguna yang menyumbang kod di GitHub.com mengaktifkan sekurang-kurangnya satu kaedah 2FA.

Simpan recovery code di lokasi yang selamat. Jangan simpan satu-satunya salinan recovery code di telefon yang sama digunakan untuk pengesahan.

Cara Mencipta Repository Pertama

Langkah 1: Pilih New Repository

Selepas log masuk, pilih pilihan untuk mencipta repository baharu.

Langkah 2: Tetapkan Nama Repository

Gunakan nama yang jelas seperti:

  • dashboard-jualan-sme
  • plugin-wordpress-faq
  • portfolio-web
  • analisis-data-banjir
  • sistem-tempahan-klinik

Elakkan nama seperti project1testnew-folder atau coding.

Langkah 3: Tulis Description

Terangkan projek dalam satu ayat.

Contoh:

Dashboard ringkas untuk menganalisis jualan bulanan SME menggunakan Python dan Streamlit.

Langkah 4: Pilih Public Atau Private

Pilih public jika projek sesuai dipamerkan kepada umum.

Pilih private jika repository mengandungi:

  • projek pelanggan;
  • sistem dalaman;
  • kod komersial;
  • assignment yang tidak boleh dikongsi;
  • maklumat sulit;
  • projek yang belum dilancarkan.

Langkah 5: Tambah README

Aktifkan pilihan README untuk memudahkan anda menulis penerangan projek.

Langkah 6: Pilih Fail .gitignore

Fail .gitignore memberitahu Git supaya tidak memasukkan fail atau folder tertentu ke dalam commit. GitHub menyediakan template .gitignore untuk pelbagai bahasa, sistem operasi dan persekitaran pembangunan.

Contoh fail yang biasa dikecualikan:

  • .env
  • folder dependency;
  • cache;
  • fail log;
  • fail sementara;
  • konfigurasi editor tertentu;
  • fail sistem operasi.

Perlu difahami bahawa memasukkan nama fail ke .gitignore tidak semestinya membuang fail yang telah pun direkodkan. Fail yang sudah dijejaki perlu dinyahjejak dengan langkah tambahan.

Langkah 7: Pilih Lesen Dengan Berhati-hati

Repository public tidak semestinya bermaksud projek itu open source.

Untuk membenarkan orang lain menggunakan, mengubah dan mengedarkan perisian secara sah, repository perlu mempunyai lesen yang sesuai. Jangan memilih lesen secara rawak jika anda tidak memahami hak yang diberikan.

Cara Upload Projek Ke GitHub Tanpa Command Line

Pemula boleh memuat naik fail melalui website GitHub.

Langkah umumnya:

  1. buka repository;
  2. pilih Add file;
  3. pilih Upload files;
  4. seret fail ke ruangan yang disediakan;
  5. semak senarai fail;
  6. tulis mesej commit;
  7. simpan perubahan.

Kaedah ini sesuai untuk:

  • projek kecil;
  • fail dokumentasi;
  • latihan pertama;
  • perubahan sekali-sekala.

Namun, ia kurang praktikal untuk projek yang mempunyai banyak fail atau sering dikemas kini. Risiko memuat naik fail sensitif juga lebih tinggi jika anda tidak menyemak setiap fail.

Untuk kerja berterusan, GitHub Desktop biasanya lebih mudah.

Cara Menggunakan GitHub Desktop

GitHub Desktop ialah aplikasi percuma dan sumber terbuka yang menyediakan antara muka visual untuk bekerja dengan repository GitHub serta perkhidmatan hosting Git lain.

Ia sesuai kepada pemula yang belum selesa menggunakan Terminal.

Langkah Asas GitHub Desktop

  1. Muat turun dan pasang GitHub Desktop.
  2. Log masuk menggunakan akaun GitHub.
  3. Clone repository ke komputer.
  4. Buka folder projek menggunakan code editor.
  5. Edit atau tambah fail.
  6. Kembali ke GitHub Desktop.
  7. Semak senarai perubahan.
  8. Tulis ringkasan commit.
  9. Klik Commit.
  10. Klik Push origin.

Dokumentasi rasmi GitHub turut menyediakan aliran pemasangan GitHub Desktop, log masuk ke GitHub.com dan penyambungan identiti Git pada komputer.

Mengapa GitHub Desktop Sesuai Untuk Pemula?

GitHub Desktop membolehkan anda melihat:

  • fail yang berubah;
  • baris yang ditambah;
  • baris yang dipadam;
  • branch aktif;
  • sejarah commit;
  • perubahan yang belum disimpan;
  • tindakan push dan pull.

Anda tetap perlu memahami konsep Git. Aplikasi visual hanya mengurangkan kebergantungan kepada command line, bukan menggantikan pemahaman.

Aliran Kerja GitHub Yang Praktikal

Gunakan aliran berikut walaupun anda bekerja seorang diri:

  1. Pull versi terkini
    Pastikan komputer mempunyai perubahan terbaru.
  2. Cipta branch baharu
    Contohnya feature-borang-hubungi.
  3. Lakukan perubahan
    Edit hanya fail yang berkaitan dengan tugasan.
  4. Uji projek
    Pastikan fungsi lama dan baharu masih berjalan.
  5. Semak perbezaan fail
    Jangan commit secara membuta tuli.
  6. Buat commit
    Tulis mesej yang menerangkan perubahan.
  7. Push branch ke GitHub
    Hantar commit ke repository dalam talian.
  8. Buka pull request
    Terangkan masalah dan penyelesaian.
  9. Semak atau minta review
    Periksa perubahan, ujian dan risiko.
  10. Merge ke main
    Gabungkan hanya selepas perubahan stabil.

Branch bukan sekadar untuk pasukan besar. Ia ialah ruang selamat untuk bereksperimen tanpa terus mengubah versi utama.

Cara Menulis Commit Message Yang Baik

Commit message perlu menjawab soalan: apakah perubahan yang dibuat?

Contoh Lemah

  • Update
  • Fix
  • Done
  • Final
  • New changes

Contoh Lebih Baik

  • Tambah validasi e-mel pada borang pendaftaran
  • Baiki menu mudah alih yang menutup logo
  • Kemas kini arahan pemasangan untuk macOS
  • Betulkan pengiraan cukai dalam laporan bulanan
  • Tambah ujian untuk fungsi reset kata laluan

Amalan Commit Yang Baik

  • Buat satu commit untuk satu perubahan berkaitan.
  • Jangan campurkan pembaikan bug, reka bentuk dan dokumentasi tanpa sebab.
  • Semak fail sebelum commit.
  • Elakkan commit terlalu besar.
  • Jangan membuat commit kosong untuk mencantikkan graf.
  • Gunakan bahasa yang konsisten.

Commit kecil lebih mudah disemak, diuji dan dibatalkan jika berlaku masalah.

Cara Menggunakan Branch Dengan Betul

Gunakan nama branch yang menerangkan tugas.

Contoh:

  • feature-login-google
  • fix-menu-mobile
  • update-dokumentasi
  • design-dashboard
  • security-remove-api-key

Elakkan nama seperti:

  • new
  • test2
  • branch-me
  • final
  • try-again

Selepas branch selesai digabungkan, padam branch tersebut jika tidak lagi diperlukan. Terlalu banyak branch lama menjadikan repository sukar diurus.

Cara Menulis Pull Request Yang Berkualiti

Pull request yang baik bukan sekadar bertulis “siap”.

Masukkan maklumat berikut:

Masalah

Apakah masalah atau keperluan asal?

Perubahan

Apakah fail atau fungsi yang diubah?

Cara Menguji

Berikan langkah jelas untuk menguji perubahan.

Bukti Visual

Sertakan screenshot jika melibatkan reka bentuk atau antara muka.

Risiko

Nyatakan batasan, isu belum selesai atau bahagian yang perlu perhatian.

Contoh ringkas:

Pull request ini membaiki menu mudah alih yang menutupi tajuk halaman pada skrin di bawah 768 piksel. Perubahan dibuat pada fail CSS navigasi. Telah diuji pada Chrome dan Safari. Paparan tablet masih perlu disemak.

Cara Membina Portfolio GitHub Yang Meyakinkan

Portfolio GitHub bukan pertandingan siapa mempunyai repository paling banyak.

Tiga projek lengkap, boleh dijalankan dan mempunyai dokumentasi jelas lebih meyakinkan daripada 30 repository kosong atau tutorial yang disalin bulat-bulat.

1. Pilih Projek Yang Menyelesaikan Masalah

Contoh projek sesuai:

  • dashboard jualan SME;
  • plugin WordPress;
  • sistem tempahan;
  • website portfolio;
  • kalkulator kewangan;
  • aplikasi pengurusan tugas;
  • analisis dataset terbuka;
  • tool audit SEO;
  • automasi laporan Excel;
  • sistem inventori ringkas.

2. Terangkan Peranan Anda

Jika projek dibina bersama pasukan, jelaskan sumbangan anda.

Jangan memberikan gambaran seolah-olah semua kerja dilakukan sendiri.

3. Sediakan README Lengkap

README portfolio sepatutnya mengandungi:

  1. nama projek;
  2. penerangan ringkas;
  3. masalah yang diselesaikan;
  4. fungsi utama;
  5. teknologi yang digunakan;
  6. cara pemasangan;
  7. cara penggunaan;
  8. screenshot;
  9. pautan demo;
  10. cabaran;
  11. pembelajaran;
  12. perancangan seterusnya.

4. Pastikan Projek Boleh Dijalankan

Arahan pemasangan mestilah tepat.

Majikan tidak sepatutnya perlu meneka:

  • versi perisian;
  • dependency;
  • command;
  • fail konfigurasi;
  • cara memulakan aplikasi.

5. Tambah Screenshot Atau Demo

Ramai penilai tidak mempunyai masa membaca semua kod.

Screenshot dan demo membantu mereka memahami hasil projek dengan cepat.

6. Kemas Repository

Buang:

  • fail sementara;
  • folder tidak digunakan;
  • gambar rawak;
  • kod mati;
  • komen tidak relevan;
  • fail salinan;
  • data sensitif.

7. Gunakan Profile README

GitHub membolehkan pengguna mencipta profile README melalui repository khas yang namanya sama dengan username.

Gunakan ruang ini untuk menerangkan:

  • siapa anda;
  • kemahiran utama;
  • projek pilihan;
  • teknologi yang dipelajari;
  • cara menghubungi anda.

Jangan memenuhi profile README dengan terlalu banyak badge, animasi atau statistik sehingga projek sebenar tenggelam.

Contoh Struktur README Projek

# Nama Projek

## Pengenalan

Terangkan projek dalam satu atau dua perenggan.

## Masalah Yang Diselesaikan

Jelaskan masalah sebenar yang mendorong projek ini.

## Fungsi Utama

- Fungsi pertama
- Fungsi kedua
- Fungsi ketiga

## Teknologi Digunakan

- Bahasa pengaturcaraan
- Framework
- Pangkalan data
- Hosting

## Cara Pemasangan

Berikan langkah pemasangan yang lengkap.

## Cara Penggunaan

Terangkan cara pengguna menjalankan projek.

## Screenshot

Masukkan paparan projek.

## Cabaran Dan Pembelajaran

Terangkan masalah yang dihadapi dan penyelesaiannya.

## Perancangan Seterusnya

Senaraikan penambahbaikan masa depan.

## Lesen

Nyatakan lesen jika berkaitan.

GitHub menggunakan Markdown untuk memformat README, issue, pull request dan pelbagai ruangan teks lain. Markdown menyokong heading, senarai, pautan, imej, jadual dan blok kod.

Public Repository Atau Private Repository?

PertimbanganPublicPrivate
Siapa boleh melihatPengguna internetPengguna yang diberikan akses
Sesuai untuk portfolioYaTerhad
Projek pelangganBiasanya tidakYa
Open sourceBoleh, dengan lesen sesuaiBiasanya tidak
Sistem dalamanTidak sesuaiLebih sesuai
Data sensitifTetap tidak dibenarkanTetap tidak wajar disimpan secara terbuka
PerkongsianMudahMemerlukan akses

Repository private bukan lesen untuk menyimpan password atau data sensitif secara cuai. Akaun boleh digodam, akses boleh tersalah diberikan dan repository boleh ditukar menjadi public.

Gunakan private repository sebagai kawalan akses, bukan sebagai pengganti amalan keselamatan.

github untuk pemula checklist ebook BukuLab Malaysia

Keselamatan Ketika Menggunakan GitHub

Jangan Commit Data Sensitif

Jangan masukkan perkara berikut ke dalam kod:

  • password;
  • API key;
  • access token;
  • private key;
  • maklumat pelanggan;
  • rekod pesakit;
  • nombor kad;
  • pangkalan data sebenar;
  • konfigurasi server;
  • fail .env.

GitHub menyediakan mekanisme secrets untuk menyimpan maklumat sensitif seperti API key, token dan password tanpa perlu menulisnya secara terus dalam kod atau workflow.

Memadam Fail Tidak Semestinya Menyelesaikan Kebocoran

Jika API key telah di-commit dan kemudian dipadam, nilainya mungkin masih wujud dalam history Git.

Tindakan pertama sepatutnya ialah membatalkan atau menukar data sensitif tersebut. Selepas itu, barulah history repository dibersihkan dengan kaedah yang sesuai.

Dokumentasi GitHub menegaskan bahawa proses membuang data sensitif daripada history mempunyai kesan sampingan dan memerlukan pengendalian teliti. git revert juga tidak mencukupi kerana commit asal masih berada dalam history.

Semak Hak Cipta Dan Pemilikan

Jangan muat naik:

  • kod milik majikan;
  • projek pelanggan;
  • theme atau plugin premium cetak rompak;
  • dataset berlesen;
  • maklumat sulit;
  • hasil kerja orang lain tanpa kebenaran.

Public repository tidak bermaksud semua kandungan bebas digunakan sesuka hati. Lesen menentukan hak yang diberikan kepada pengguna lain.

GitHub Dan AI Coding Tools

AI boleh membantu menghasilkan kod, tetapi GitHub menyediakan kawalan yang diperlukan untuk menilai hasil tersebut.

Aliran Kerja AI Yang Lebih Selamat

  1. Pastikan repository berada dalam keadaan stabil.
  2. Commit perubahan semasa.
  3. Cipta branch baharu.
  4. Berikan tugasan khusus kepada AI.
  5. Semak setiap fail yang diubah.
  6. Jalankan projek.
  7. Jalankan ujian.
  8. Periksa isu keselamatan.
  9. Buat commit kecil.
  10. Buka pull request sebelum merge.

Jangan Terus Percaya Kod Yang Kelihatan Meyakinkan

Kod AI boleh:

  • menggunakan library yang salah;
  • menghasilkan fungsi yang tidak lengkap;
  • mencipta kelemahan keselamatan;
  • memadam validasi;
  • mengubah fail tidak berkaitan;
  • menulis ujian yang sebenarnya tidak menguji apa-apa;
  • mendedahkan maklumat sensitif.

AI boleh mempercepat kerja. GitHub pula membantu memastikan kelajuan tersebut tidak mengorbankan kawalan.

Kesalahan Biasa Pengguna GitHub Baru

Menggunakan GitHub Sebagai Backup Tunggal

GitHub membantu menyimpan salinan repository dalam talian, tetapi projek penting masih memerlukan strategi backup tambahan.

Membuat Semua Perubahan Pada Main

Tabiat ini meningkatkan risiko versi utama rosak.

Tidak Membaca Diff

Diff menunjukkan baris yang ditambah dan dipadam. Jangan commit atau merge tanpa menyemaknya.

Mesej Commit Tidak Jelas

Mesej seperti update tidak berguna apabila anda cuba memahami perubahan enam bulan kemudian.

Tidak Menulis README

Kod yang baik tanpa dokumentasi tetap sukar dinilai.

Memuat Naik Tutorial Bulat-bulat

Tutorial boleh digunakan untuk belajar, tetapi projek portfolio perlu menunjukkan penyesuaian, keputusan dan penyelesaian anda sendiri.

Mengejar Contribution Graph

Graf hijau bukan bukti automatik bahawa seseorang ialah developer yang baik.

Majikan lebih berminat kepada:

  • kualiti projek;
  • keupayaan menerangkan keputusan;
  • pemahaman kod;
  • cara menyelesaikan masalah;
  • dokumentasi;
  • hasil yang boleh diuji.

Menyimpan Data Sensitif Dalam Repository Private

Repository private masih tidak sesuai untuk menyimpan password secara terus dalam kod.

Pelan Belajar GitHub Selama Tujuh Hari

Hari 1: Fahami Konsep Asas

Pelajari repository, commit, branch, push dan pull.

Hari 2: Buka Akaun Dan Lengkapkan Profil

Pilih username profesional, aktifkan 2FA dan tulis bio.

Hari 3: Cipta Repository Pertama

Tambah README, description dan .gitignore.

Hari 4: Gunakan GitHub Desktop

Clone repository, edit fail, commit dan push.

Hari 5: Belajar Branch

Cipta branch dan lakukan satu perubahan kecil.

Hari 6: Buka Pull Request

Tulis penerangan perubahan, semak diff dan merge.

Hari 7: Susun Portfolio

Pilih satu projek, lengkapkan README, tambah screenshot dan kemas profil.

Selepas tujuh hari, anda belum menjadi pakar Git. Namun, anda sudah mempunyai aliran kerja yang lebih baik daripada menyimpan projek dalam folder bernama final-final-betul.

Checklist Repository Portfolio

Sebelum berkongsi repository dengan majikan atau pelanggan, semak perkara berikut:

  • Nama repository jelas.
  • Description telah ditulis.
  • README lengkap.
  • Masalah projek diterangkan.
  • Fungsi utama disenaraikan.
  • Arahan pemasangan berfungsi.
  • Screenshot disediakan.
  • Pautan demo berfungsi.
  • Tiada password atau API key.
  • Fail .env tidak dimuat naik.
  • Struktur folder mudah difahami.
  • Commit message jelas.
  • Kod boleh dijalankan.
  • Lesen dinyatakan jika perlu.
  • Peranan anda diterangkan dengan jujur.

Kesimpulan

GitHub bukan hanya tempat menyimpan kod. Ia ialah sistem kerja untuk merekod perubahan, mengurangkan risiko, bekerjasama dan membuktikan kemahiran.

Sebagai pemula, anda tidak perlu menghafal puluhan command pada hari pertama. Mulakan dengan asas:

  1. cipta repository;
  2. tambah README;
  3. buat perubahan kecil;
  4. tulis commit yang jelas;
  5. gunakan branch;
  6. semak diff;
  7. push ke GitHub;
  8. bina satu projek yang benar-benar berguna.

Portfolio GitHub yang baik tidak bergantung pada bilangan repository atau contribution graph yang sentiasa hijau. Ia bergantung pada projek yang boleh difahami, dijalankan dan diterangkan.

Majikan tidak hanya mahu melihat bahawa anda boleh menghasilkan kod. Mereka mahu melihat bahawa anda boleh mengurus perubahan, mendokumentasikan kerja, mengesan masalah dan membuat keputusan secara tersusun.

Mahu Membina Kerjaya Dalam Bidang Teknologi Dan AI?

Belajar GitHub ialah salah satu langkah praktikal untuk memasuki bidang pembangunan perisian, data, automasi dan teknologi digital.

Namun, kemahiran teknikal sahaja tidak mencukupi. Anda juga perlu memahami bidang pengajian, laluan kerjaya, permintaan industri dan kemahiran yang semakin penting dalam era kecerdasan buatan.

Dapatkan ebook:

STEM Untuk Anak Muda Malaysia: Panduan Pilih Kerjaya, Course Dan Kerja Bergaji Tinggi Dalam Era AI

Ebook ini membantu pelajar dan golongan muda:

  • mengenal pasti bidang STEM yang sesuai;
  • memahami pilihan course dan laluan pendidikan;
  • menilai prospek kerjaya dalam era AI;
  • merancang kemahiran yang diperlukan industri;
  • mengelakkan pilihan pengajian berdasarkan trend semata-mata;
  • membina hala tuju kerjaya yang lebih realistik.

Jangan tunggu sehingga tamat pengajian untuk mula membina portfolio. Pilih satu masalah, bina satu projek dan dokumentasikan proses anda di GitHub.

Soalan Lazim Tentang GitHub

Adakah GitHub percuma untuk digunakan?

Ya. Pelan GitHub Free menyediakan kemudahan asas untuk individu dan organisasi, termasuk repository public dan private tanpa had. Ciri tertentu untuk pasukan, keselamatan lanjutan atau penggunaan perusahaan mungkin memerlukan pelan berbayar. Struktur pelan boleh berubah, jadi semak halaman harga rasmi sebelum membuat keputusan.

Adakah saya perlu tahu coding sebelum menggunakan GitHub?

Tidak semestinya. Anda boleh menggunakan GitHub untuk dokumentasi, nota projek dan fail berasaskan teks. Namun, pengetahuan asas coding dan Git akan membantu anda menggunakan platform dengan lebih berkesan.

Apakah perbezaan Git dan GitHub?

Git ialah sistem kawalan versi yang merekod perubahan pada komputer. GitHub ialah platform dalam talian untuk menyimpan repository Git dan bekerjasama dengan orang lain.

Bolehkah GitHub digunakan tanpa command line?

Ya. Anda boleh menggunakan website GitHub atau GitHub Desktop. Command line memberikan kawalan lebih luas, tetapi bukan syarat untuk mula belajar.

Apakah fungsi commit?

Commit menyimpan rekod perubahan pada sesuatu titik. Ia membolehkan anda melihat sejarah projek dan memahami apa yang telah diubah.

Apakah fungsi branch?

Branch menyediakan ruang kerja berasingan supaya anda boleh menguji perubahan tanpa terus mengganggu versi utama.

Perlukah projek peribadi menggunakan branch?

Untuk perubahan kecil, branch mungkin kelihatan berlebihan. Namun, menggunakan branch ialah latihan yang baik dan sangat berguna apabila anda membuat perubahan besar atau menggunakan AI coding tool.

Apakah perbezaan repository public dan private?

Repository public boleh dilihat oleh pengguna internet. Repository private hanya boleh diakses oleh pengguna yang diberikan kebenaran.

Adakah repository public automatik menjadi open source?

Tidak. Projek memerlukan lesen yang sesuai untuk menerangkan hak penggunaan, pengubahsuaian dan pengedaran.

Bolehkah saya menyimpan assignment di GitHub?

Boleh, tetapi gunakan private repository jika assignment tidak dibenarkan untuk dikongsi. Patuhi polisi institusi dan jangan membantu aktiviti plagiarisme.

Bolehkah saya meletakkan projek tutorial dalam portfolio?

Boleh, tetapi tambah penyesuaian sendiri. Terangkan apa yang diubah, masalah yang diselesaikan dan perkara yang dipelajari.

Berapa banyak projek diperlukan untuk portfolio GitHub?

Tiada jumlah wajib. Tiga hingga lima projek lengkap dan berkualiti biasanya lebih berguna daripada banyak repository yang tidak siap.

Adakah contribution graph penting kepada majikan?

Ia boleh menunjukkan aktiviti, tetapi bukan ukuran mutlak. Kualiti projek, dokumentasi dan pemahaman teknikal lebih penting.

Apakah maklumat yang tidak boleh dimuat naik ke GitHub?

Jangan muat naik password, API key, token, private key, data pelanggan, maklumat perubatan, kod sulit atau fail konfigurasi rahsia.

Bolehkah GitHub digunakan bersama ChatGPT atau Codex?

Ya. AI boleh membantu menghasilkan atau mengubah kod, manakala GitHub digunakan untuk merekod, menyemak dan mengawal perubahan tersebut. Semua kod AI masih perlu diuji dan disemak manusia.

Leave a Reply

Alamat e-mel anda tidak akan disiarkan. Medan diperlukan ditanda dengan *