Đưa kho mã lên GitHub để sao lưu, chia sẻ và làm việc nhóm; kết nối kho trên máy với kho trên mạng.

30 phútCơ bản
Bạn sẽ học được
  • Tạo kho trên GitHub
  • Dùng remote, push, pull, clone
  • Viết README tốt
  • Giới thiệu GitHub Pages
Thuật ngữ cần biết
origin
Tên mặc định của remote.
push
Đẩy commit từ máy lên remote.
pull
Kéo commit mới từ remote về máy.
clone
Sao chép cả kho từ remote về máy.
Fork
Bản sao kho của người khác về tài khoản của bạn.

Một số khái niệm

Remote là bản sao của kho ở nơi khác, thường là GitHub, có tên mặc định origin. Các lệnh đồng bộ: push đưa commit của bạn lên remote; fetch tải commit mới về nhưng chưa gộp; pull là fetch rồi merge; clone sao chép toàn bộ kho về máy lần đầu.

Nhánh trên máy (main) và nhánh theo dõi từ xa (origin/main) là hai thứ khác nhau; Git so sánh chúng để báo bạn đang "đi trước" hay "tụt sau". Nếu remote có commit bạn chưa có, push bị từ chối cho đến khi bạn pull để hợp nhất.

README.md là bộ mặt của kho: viết bằng Markdown, GitHub tự hiển thị. Giấy phép (license) cho biết người khác được dùng mã của bạn thế nào; không có license nghĩa là mặc định không ai được phép sao chép.

Đưa dự án lên GitHub

  1. Trên github.com, bấm New repository, đặt tên (không dấu), chọn Public hoặc Private, không tích thêm README.
  2. Trong thư mục dự án chạy các lệnh dưới đây.
git remote add origin Địa chỉ email này đang được bảo vệ từ spam bots, bạn cần kích hoạt Javascript để xem nó. Bạn cần kích hoạt Javascript để xem nó.:ten-ban/ten-kho.git
git branch -M main
git push -u origin main

Đồng bộ hằng ngày

git pull        # lấy thay đổi mới từ GitHub
# ... làm việc, commit ...
git push        # đẩy lên

git clone Địa chỉ email này đang được bảo vệ từ spam bots, bạn cần kích hoạt Javascript để xem nó. Bạn cần kích hoạt Javascript để xem nó.:ten-ban/ten-kho.git   # lấy kho về máy mới

Ví dụ: đưa một thư mục lên GitHub

Vào trang tạo kho mới, đặt tên kho, chọn Public hoặc Private rồi bấm tạo. Trong thư mục dự án trên máy, chạy:

git remote add origin <địa-chỉ-kho>
git branch -M main
git push -u origin main

Tải lại trang GitHub, mã của bạn đã ở đó. Từ lần sau chỉ cần gõ git push. Đừng quên thêm tệp .gitignore để không đưa nhầm mật khẩu hay tệp tạm lên mạng.

README tốt

  • Tên dự án và mô tả một câu.
  • Ảnh chụp màn hình hoặc demo.
  • Cách cài đặt, cách chạy.
  • Công nghệ dùng, giấy phép (license).
# Sổ chi tiêu
Ứng dụng quản lý chi tiêu bằng Python.

## Cài đặt
pip install -r requirements.txt

## Chạy
python main.py

GitHub Pages

Vào Settings → Pages, chọn nhánh main. Trang web tĩnh của bạn có địa chỉ ten-ban.github.io/ten-kho, miễn phí.

Tình huống: Hồ sơ năng lực

Nhà tuyển dụng thường xem GitHub của ứng viên. Giữ các kho gọn gàng có README rõ ràng, commit đều đặn, sẽ tạo ấn tượng tốt hơn bất kỳ lời mô tả nào.

Mẹo hay

Ghim (pin) 6 kho tốt nhất lên trang hồ sơ GitHub và viết README giới thiệu bản thân.

Lưu ý

Kho Public ai cũng xem được; kiểm tra không có mật khẩu, khóa API, dữ liệu cá nhân trước khi đẩy.

Thực hành
  1. Tạo kho GitHub và đẩy dự án Python ở loạt bài trước.
  2. Viết README có mục cài đặt và chạy.
  3. Clone kho về thư mục khác và chạy thử.
Tóm tắt bài học
  • remote add, push, pull, clone.
  • README là bộ mặt của dự án.
  • GitHub Pages đăng web tĩnh miễn phí.