Frontend Academy · บทเรียน

เวิร์กโฟลว์ Pull Request บน GitHub

เปิด pull request บน GitHub เขียนคำอธิบายที่เป็นประโยชน์ ตอบความคิดเห็นจากการรีวิวโค้ด และรวมการเปลี่ยนแปลงเมื่อได้รับอนุมัติ

เวิร์กโฟลว์ Pull Request บน GitHub เป็นบทเรียน Frontend Academy ฟรีบน CoddyKit นี่คือบทเรียนที่ 4 จากทั้งหมด 4 บทเรียน คุณสามารถอ่านบทเรียนทั้งหมดด้านล่างฟรี — จากนั้นลองปฏิบัติด้วยตัวคุณเองในเบราว์เซอร์พร้อมตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7 บทเรียนนี้เป็นส่วนหนึ่งของเส้นทางการเรียน Frontend Academy และความก้าวหน้าของคุณจะซิงค์ข้ามเว็บและแอป CoddyKit คอร์ส Frontend Academy มีบทเรียนทั้งหมด 4 บทเรียน

คำขอรวมโค้ดคืออะไร

คำขอรวมโค้ด (PR) คือข้อเสนอให้ผสานสาขาหนึ่งเข้ากับอีกสาขา บน GitHub คำขอนี้จะสร้างกระทู้สนทนาที่เพื่อนร่วมทีมใช้ตรวจสอบโค้ด แสดงความคิดเห็น ขอให้แก้ไข และอนุมัติการผสานในท้ายที่สุด

การสร้าง PR บน GitHub

หลังจากส่งสาขาฟีเจอร์ไปยัง GitHub แล้ว จะมีแถบประกาศสีเหลืองเสนอให้เปรียบเทียบและสร้าง PR ให้คลิกแถบนั้น หรือไปที่ คำขอรวมโค้ด → คำขอรวมโค้ดใหม่ แล้วเลือกสาขาของคุณ

การเขียนคำอธิบาย PR ที่ดี

คำอธิบาย PR ที่ดีควรอธิบายว่าเปลี่ยนแปลง อะไร และ ทำไม หากมีการเปลี่ยนแปลงส่วนติดต่อผู้ใช้ ให้แนบภาพหน้าจอและลิงก์ไปยังปัญหาที่เกี่ยวข้อง อธิบายวิธีที่คุณทดสอบ การอ่านคำอธิบายควรทำให้เข้าใจเจตนาได้โดยไม่จำเป็นต้องอ่านโค้ด

## Summary
Adds dark mode support using CSS custom properties.

## Why
Users requested dark mode (#123). Reduces eye strain for evening use.

## Testing
- Toggled dark/light mode on macOS and Windows
- Verified `prefers-color-scheme: dark` auto-triggers
- Tested with a screen reader (macOS VoiceOver)

การขอผู้ตรวจสอบ

มอบหมายเพื่อนร่วมทีมที่ระบุให้เป็นผู้ตรวจสอบ พวกเขาจะได้รับการแจ้งเตือนและสามารถอนุมัติ ขอให้แก้ไข หรือแสดงความคิดเห็นได้ ทีมส่วนใหญ่กำหนดให้มีการอนุมัติอย่างน้อยหนึ่งครั้งก่อนผสาน

การอ่านความคิดเห็นในการตรวจสอบโค้ด

ความคิดเห็นจะแสดงแทรกอยู่ในบรรทัดที่มีการเปลี่ยนแปลง ผู้ตรวจสอบสามารถขอคำชี้แจง เสนอแนวทางอื่น หรืออนุมัติได้ โปรดตอบทุกความคิดเห็น ไม่ว่าจะด้วยการแก้ไขโค้ดหรือเหตุผลที่ไม่แก้ไข

การตอบสนองต่อการแก้ไขที่ร้องขอ

เมื่อผู้ตรวจสอบขอให้แก้ไข ให้ส่งคอมมิตใหม่ไปยังสาขาเดิม PR จะอัปเดตโดยอัตโนมัติ จัดการการสนทนาแต่ละรายการโดยคลิก 'แก้ไขการสนทนา' หลังจากดำเนินการแล้ว

PR ฉบับร่าง

เปิด PR เป็น ฉบับร่าง เพื่อแสดงว่ายังเป็นงานที่กำลังดำเนินการอยู่ PR ฉบับร่างยังเปิดให้ตรวจสอบและพูดคุยได้ แต่ไม่สามารถผสานโดยไม่ตั้งใจ เมื่อเสร็จสมบูรณ์แล้วให้เปลี่ยนเป็นพร้อมตรวจสอบ

การทำให้สาขาเป็นปัจจุบัน

เมื่อสาขาหลักมีการเปลี่ยนแปลงระหว่างการตรวจสอบ ให้จัดประวัติสาขาของคุณใหม่โดยอิงจากสาขาหลักล่าสุด เพื่อหลีกเลี่ยงความขัดแย้งและทำให้มั่นใจว่าการเปลี่ยนแปลงของคุณทำงานร่วมกับโค้ดใหม่ได้

git fetch origin
git rebase origin/main
git push --force-with-lease origin feature/dark-mode

การผสานแบบบีบรวม เทียบกับคอมมิตการผสานและการจัดประวัติใหม่

GitHub มีวิธีผสานสามแบบ ได้แก่ คอมมิตการผสาน (รักษาคอมมิตทั้งหมดไว้), บีบรวมแล้วผสาน (หนึ่งคอมมิตต่อ PR ทำให้ประวัติของสาขาหลักสะอาด) และ จัดประวัติใหม่แล้วผสาน (เป็นเส้นตรงและไม่มีคอมมิตการผสาน) โดยทั่วไปทีมจะเลือกใช้วิธีใดวิธีหนึ่งเพื่อความสม่ำเสมอ

กฎการป้องกันสาขา

ป้องกันสาขาหลักโดยกำหนดให้มีการตรวจสอบ PR กำหนดให้การตรวจสอบสถานะผ่าน และห้ามส่งคอมมิตโดยตรง ตั้งค่าได้ที่ GitHub → การตั้งค่า → สาขา

มารยาทในการใช้ PR

ทำให้ PR มีขนาดเล็กและมุ่งเน้นประเด็นเดียว ใช้หนึ่ง PR ต่อหนึ่งฟีเจอร์หรือการแก้ไข PR ขนาดใหญ่ตรวจสอบได้ยาก ตอบความคิดเห็นในการตรวจสอบภายในหนึ่งวัน ขอบคุณผู้ตรวจสอบ และมีน้ำใจ เพราะการตรวจสอบโค้ดเป็นโอกาสในการสอน ไม่ใช่การตรวจสอบเพื่อจับผิด

ตรวจสอบอย่างรวดเร็ว

คำอธิบาย PR ที่ดีควรมีอะไรบ้าง

สรุป: ลำดับการทำงานของ Pull Request

ส่งสาขาฟีเจอร์ → เปิด PR พร้อมคำอธิบายที่ชัดเจน → ขอผู้ตรวจสอบ → ดำเนินการตามข้อเสนอแนะด้วยคอมมิตใหม่ → ทำให้สาขาเป็นปัจจุบันด้วยการจัดประวัติใหม่ → รับการอนุมัติ → ผสาน ให้ PR มีขนาดเล็ก มุ่งเน้นประเด็นเดียว และอธิบายไว้อย่างดี กฎการป้องกันสาขาช่วยบังคับใช้คุณภาพบนสาขาหลัก

คำถามที่พบบ่อย

บทเรียน “เวิร์กโฟลว์ Pull Request บน GitHub” ฟรีหรือไม่

ใช่ — ข้อความเต็มของ “เวิร์กโฟลว์ Pull Request บน GitHub” ฟรีให้อ่านที่นี่บนเว็บ เพื่อปฏิบัติแบบโต้ตอบ (ตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7) และปลดล็อคส่วนที่เหลือของคอร์ส Frontend Academy ให้อัปเกรดเป็น CoddyKit PRO คอร์ส Frontend Academy มีบทเรียนทั้งหมด 4 บทเรียน

คุณจะเรียนรู้อะไรในบทเรียน “เวิร์กโฟลว์ Pull Request บน GitHub”

เปิด pull request บน GitHub เขียนคำอธิบายที่เป็นประโยชน์ ตอบความคิดเห็นจากการรีวิวโค้ด และรวมการเปลี่ยนแปลงเมื่อได้รับอนุมัติ คุณปฏิบัติ Frontend Academy ด้วยโค้ดที่ใช้งานได้จริงที่คุณเรียกใช้โดยตรงในเบราว์เซอร์ และติวเตอร์ AI ตลอด 24/7 ตอบคำถามของคุณขณะที่คุณไปผ่านบทเรียน

คุณต้องมีประสบการณ์ก่อนที่จะเริ่มเรียน Frontend Academy หรือไม่

ไม่จำเป็นต้องมีประสบการณ์มาก่อน Frontend Academy บน CoddyKit ออกแบบมาสำหรับผู้เริ่มต้นไปจนถึงผู้เรียนขั้นสูง คุณสามารถเริ่มต้นที่นี่หรือเริ่มจากตัวแรกและเรียนด้วยความเร็วของคุณเอง นี่คือบทเรียนที่ 4 จากทั้งหมด 4 บทเรียน

บทเรียน “เวิร์กโฟลว์ Pull Request บน GitHub” ใช้เวลานานแค่ไหน

บทเรียน CoddyKit ส่วนใหญ่ใช้เวลาประมาณ 5–10 นาที แต่ละบทเรียนจึงสั้นและเป็นแบบโต้ตอบ คุณสามารถก้าวหน้าอย่างต่อเนื่องและกลับมาเรียนต่อจากตรงที่เพิ่งหยุดบนเว็บและแอปได้เลย

ฉันเขียนและรันโค้ดในบทเรียน Frontend Academy นี้ได้ไหม

ได้ บทเรียน Frontend Academy ทุกบทมีตัวแก้ไขโค้ดในตัว คุณจึงเขียนและรันโค้ดจริงได้เลยในเบราว์เซอร์ และได้รับข้อเสนอแนะจาก AI ในทันที — ไม่ต้องติดตั้งในเครื่องของคุณ

บทเรียนทั้งหมดในหลักสูตรนี้

← กลับไปที่ Frontend Academy