Builder Toolkit · 04 / 11

Asas GitHub

Buat repository, set identiti Git, commit, push, dan fahami apa yang version control beri kepada anda.

Asas GitHub

Apa ini

Git merekod versi project anda pada komputer anda. GitHub menyimpan salinan sejarah itu secara online.

Ia dua benda berbeza dengan nama yang mengelirukan serupa. Git ialah toolnya. GitHub ialah websitenya.

Satu idea utama

Commit ialah save point yang anda boleh kembali kepadanya. Push menyalin save point anda ke GitHub.

Kenapa penting

Tanpa ini, project anda wujud di satu tempat sahaja dan dalam satu keadaan sahaja. Satu edit AI yang buruk, satu folder terpadam, atau satu laptop mati akan bawa semuanya.

Dengannya, anda boleh undo perubahan buruk, tunjuk tutor tepat apa yang anda buat, dan sambungkan project ke tool deployment. Deployment baca dari GitHub, jadi tiada apa yang ship sebelum langkah ini berjaya.

Apa nak buat

Fahami alirannya

Copy

your folder → git commit → GitHub repository → deploy

Setiap anak panah ialah tindakan berasingan yang anda cetuskan. Tiada apa berlaku sendiri.

Set identiti anda dahulu

Git enggan commit kalau ia tidak tahu siapa anda, dan mesej errornya tidak jelaskan itu. Set sekali untuk setiap mesin:

Terminal command

git config --global user.name "Your Name"
git config --global user.email "your@email.com"

Swipe sideways if a command is long.

Guna email yang sama dengan account GitHub anda supaya commit anda terikat kepada anda.

Penyekat senyap

Identiti yang tidak di-set ialah sebab paling biasa commit pertama gagal dalam kelas. Ia nampak macam repository rosak. Sebenarnya ia dua baris config.

Buat account dan repository

Buat account di github.com dan sahkan email anda.
Hidupkan two-factor authentication bila diminta.
Klik New repository.
Guna nama huruf kecil yang ringkas seperti cafe-website.
Pilih Public untuk kerja kelas atau Private untuk kerja peribadi.
Jangan tambah README kalau anda nak push project yang sudah wujud di local.

Poin terakhir itu penting. Tambah README mencipta commit pertama di GitHub yang project local anda tidak ada, dan kedua-dua sejarah itu kemudian enggan bergabung.

Push project sedia ada

Run ini di dalam folder project anda:

Terminal command

git init
git add .
git commit -m "Initial commit"
git branch -M main
git remote add origin https://github.com/USERNAME/REPO-NAME.git
git push -u origin main

Swipe sideways if a command is long.

Selepas push pertama, loop harian anda hanya tiga command:

Terminal command

git add .
git commit -m "Describe what changed"
git push

Swipe sideways if a command is long.

Buat sekarang

Run git status dalam folder project anda. Ia beritahu apa yang berubah sejak commit terakhir. Biasakan run ini sebelum setiap commit.

Check sendiri

git config --global user.name cetak nama saya.
Halaman repository saya di GitHub tunjuk file project saya.
Saya boleh buat perubahan kecil, commit, dan nampak ia muncul di GitHub.
Saya tahu git status tunjuk apa yang bakal di-commit.

Kenali istilahnya

Istilah	Maksud	Apa anda buat sekarang
Repository	Folder dan sejarah satu project	Satu project, satu repository.
Commit	Checkpoint tersimpan dengan mesej	Commit selepas setiap perubahan yang berjaya.
Push	Hantar commit ke GitHub	Push sebelum deploy.
Branch	Garisan kerja berasingan	Kekal di `main` untuk build pertama anda.
Remote	Sambungan GitHub	Milik anda dipanggil `origin`.
Pull request	Aliran review	Belajar kemudian. Tidak perlu untuk ship.

Kalau push ditolak

Biasanya URL remote salah, atau repository sudah ada commit yang anda tiada. Semak URL dengan git remote -v dan betulkan dengan git remote set-url origin <correct-url>.

Common mistakes

Commit tanpa set identiti Git, kemudian baca kegagalannya sebagai install rosak.
Buat repo GitHub dengan README, kemudian bergelut dengan merge conflict pada push pertama.
Tulis mesej commit macam update yang tidak beritahu apa-apa kepada diri anda nanti.
Deploy sebelum push, kemudian hairan kenapa site live tiada perubahan anda.
Upload node_modules atau file secrets, yang halaman seterusnya halang.

Next step

Sebelum anda push apa-apa lagi, kenali apa yang tidak boleh keluar dari mesin anda: Gitignore dan Secrets.