เผยแพร่เมื่อ 2026-10-28
# QR Code สำหรับ GitHub: ใส่ Repo ของคุณในสแกนครั้งเดียว
GitHub QR code คือสัญลักษณ์ 2 มิติที่เปิดหน้า GitHub — โดยปกติคือ repository แต่รวมถึง profile, gist หรือ issue — ในเบราว์เซอร์ของผู้ที่สแกน มันมีอยู่เพราะการประชุม งานประกาศรับสมัครงาน และไฟล์ README กำลังถูกอ่านบนโทรศัพท์มากขึ้น และการพิมพ์ github.com/username/repo-name บนคีย์บอร์ดมือถือเป็นจุดขัดข้องจริง ๆ GitHub แพลตฟอร์มโฮสต์โค้ดที่กล่าวถึงในบทความ Wikipedia ทำให้การเรียกดู repository บนมือถือเป็นนิสัยปกติ สัญลักษณ์นี้เข้ารหัส URL https ทั่วไปตามมาตรฐาน ISO/IEC 18004 ของ DENSO WAVE ดังนั้นจึงไม่จำเป็นต้องใช้แอปหรือเข้าสู่ระบบ GitHub เพื่อสแกน สร้างสัญลักษณ์ด้วย สร้าง QR Code สำหรับ URL และรักษาขนาดอย่างน้อย 25 มม. บนป้ายชื่อหรือโปสเตอร์
URL GitHub ใดบ้างที่เหมาะกับ QR code
ไม่ใช่ทุกที่อยู่ GitHub ที่คุ้มค่ากับการสร้างสัญลักษณ์ สิ่งที่นักพัฒนาแชร์จริง ๆ:
| เนื้อหา | URL pattern | ตัวอย่าง | เหมาะกับ |
|---|---|---|---|
| Repo | https://github.com/{user}/{repo} | https://github.com/jdoe/cli-tool | ป้าย README, งานพูด, resume |
| โปรไฟล์ | https://github.com/{user} | https://github.com/jdoe | นามบัตร, ป้ายชื่อการประชุม |
| Gist | https://gist.github.com/{user}/{id} | https://gist.github.com/jdoe/9a1b2c | แชร์สคริปต์หรือโค้ดสั้น |
| Issue | https://github.com/{user}/{repo}/issues/{n} | https://github.com/jdoe/cli-tool/issues/142 | รายงานบั๊กในงานอีเวนต์และการสาธิต |
| ไฟล์ใน repo | https://github.com/{user}/{repo}/blob/main/{file} | https://github.com/jdoe/cli-tool/blob/main/README.md | ชี้ไปยังเอกสารที่เจาะจง |
| องค์กร | https://github.com/orgs/{org} | https://github.com/orgs/acme-dev | หน้าทีม, การสรรหา |
หมายเหตุเกี่ยวกับรูปแบบบางประการ เส้นทาง blob แสดงไฟล์พร้อมการไฮไลต์ไวยากรณ์ ซึ่งคือสิ่งที่คุณต้องการเมื่อมีคนสแกนอ้างอิง README; ลิงก์ raw สำหรับเครื่องจักร URL ของ Issue ยาว ซึ่งผลักดันให้สัญลักษณ์ขยับขึ้นเวอร์ชัน — ตารางขนาดด้านล่างแสดงต้นทุน และหาก repo เป็นส่วนตัว QR จะช่วยแค่การพิมพ์: ผู้สแกนยังคงต้องมีบัญชี GitHub และสิทธิ์เข้าถึง
ขนาด QR ต่อประเภท URL วัดจริง
เราสร้างสัญลักษณ์หนึ่งตัวสำหรับแต่ละประเภท URL ที่ระดับการแก้ไขข้อผิดพลาด M และบันทึกเวอร์ชัน:
| URL type | ความยาวตัวอย่าง | เวอร์ชัน QR (M) | จำนวนโมดูล | Min print at 0.35 mm |
|---|---|---|---|---|
| โปรไฟล์ (22 อักขระ) | 22 | 2 | 25 x 25 | 8.75 mm |
| Repository (35 อักขระ) | 35 | 3 | 29 x 29 | 10.15 mm |
| Gist (58 อักขระ) | 58 | 4 | 33 x 33 | 11.55 mm |
| Issue ที่มีหมายเลข (55 อักขระ) | 55 | 4 | 33 x 33 | 11.55 mm |
| เส้นทาง blob (74 อักขระ) | 74 | 5 | 37 x 37 | 12.95 mm |
URL ของ profile เป็นตัวเดียวที่พอดีในสัญลักษณ์ Version 2; ทุกอย่างที่มีส่วน path จะอยู่ที่ Version 3 หรือ 4 สำหรับสัญลักษณ์ขนาด 25 มม. บนป้ายชื่อ ทั้งห้าประเภทสแกนได้อย่างสบาย ซึ่งคือเหตุผลที่การเลือกประเภท URL ควรขึ้นอยู่กับเนื้อหา ไม่ใช่ขนาด ตัวเลขความจุพื้นฐานอยู่ใน QR Code เก็บข้อมูลได้มากแค่ไหน? และกฎขนาดโมดูลอยู่ใน QR Code สามารถเล็กที่สุดได้แค่ไหน?
ตำแหน่งที่นักพัฒนาใช้ GitHub QR code จริง ๆ
| ตำแหน่ง | รูปแบบ | ใครเป็นผู้สแกน |
|---|---|---|
| ป้ายชื่อการประชุม | 25 มม. มุมล่างของป้ายชื่อ | ผู้เข้าร่วมงานคนอื่น ไม่ต้องยื่นโทรศัพท์ให้ |
| resume หรือ CV | 15 ถึง 20 มม. ถัดจากบรรทัดรายการโปรเจกต์ | ผู้สรรหาที่อ่านบนโทรศัพท์ |
| ส่วนท้าย README | 64 px ใน repo เรนเดอร์ในเบราว์เซอร์ | ผู้อ่านที่ต้องการลิงก์บนมือถือ |
| สไลด์สำหรับงานพูด | 120 px บนสไลด์สุดท้าย | ผู้ฟัง ระหว่างงานพูด |
| นามบัตร | 16 mm, corner | งานสร้างเครือข่าย ถือด้วยมือข้างเดียว |
ใน README QR คือความสะดวกสำหรับคนบนโทรศัพท์; ข้อความ URL ข้าง ๆ ทำหน้าที่เดียวกันสำหรับคนอื่น ๆ QR ในสไลด์ควรอยู่บนสไลด์สุดท้าย ไม่ใช่สไลด์หน้าปก เพราะคนไม่สแกนก่อนรู้ว่างานพูดคุ้มค่ากับการสแกน กฎขนาดเดียวกันใช้กับลิงก์เว็บไซต์ใด ๆ ตามที่อธิบายใน QR Code สำหรับเว็บไซต์: ฟิลด์ URL และข้อจำกัด Redirect
พฤติกรรมการสแกน: โทรศัพท์ทำอะไรกับโค้ดนี้
- แอปกล้องถอดรหัส URL และส่งต่อให้เบราว์เซอร์เริ่มต้น ไม่จำเป็นต้องใช้แอป GitHub
- https ทำงานได้ทุกที่; http ถูกปฏิเสธโดยแอปกล้องบางตัว ดังนั้นจึงต้องเข้ารหัส https เสมอ
- หน้าที่ถูกเรนเดอร์โหลดเหมือน URL ที่พิมพ์ รวมถึงคำขอเข้าสู่ระบบสำหรับ repo ส่วนตัว
- การถอดรหัสเองนั้นเร็ว: สัญลักษณ์ถูกแก้ไขในเวลาน้อยกว่าหนึ่งวินาที และความล่าช้าใด ๆ คือการโหลดหน้า ไม่ใช่ QR เราจับเวลา 20 ครั้งของการสแกนโค้ด repo Version 3 และการถอดรหัสเฉลี่ยน้อยกว่าครึ่งวินาทีมาก
หากลิงก์เบื้องหลังโค้ดอาจเปลี่ยน (การเปลี่ยนชื่อ repo, การย้ายไปยัง org ใหม่) ให้ชี้ QR ไปที่ลิงก์สั้นที่เสถียรแทนและเปลี่ยนเส้นทางภายหลัง นั่นคือข้อแลกเปลี่ยนมาตรฐาน QR Code แบบสถิตกับแบบไดนามิก: แบบไหนที่คุณต้องการจริงๆ? และการเปลี่ยนชื่อ repo เกิดบ่อยพอที่จะมีความสำคัญ
ขั้นตอนการทำงานสามขั้น
- คัดลอก URL GitHub ที่แน่นอน รวมถึง https ไปยัง สร้าง QR Code สำหรับ URL
- สร้างที่ระดับการแก้ไขข้อผิดพลาด M, 400 px และตรวจสอบว่าข้อความที่ถอดรหัสตรงกับ URL ตัวอักษรต่อตัวอักษร
- ทดสอบการพิมพ์ด้วยกล้องของคุณเองและโทรศัพท์อีกเครื่องหนึ่ง จากนั้นวาง PNG ลงในป้ายชื่อ สไลด์ หรือ README
การตรวจสอบบนเดสก์ท็อปอย่างรวดเร็วก่อนพิมพ์เป็นไปได้ด้วย เครื่องสแกน QR Code ออนไลน์ฟรี หากการออกแบบป้ายชื่อบรรลุโลโก้ ให้เก็บโลโก้ให้ออกจาก quiet zone; กฎอยู่ใน เครื่องมือตกแต่ง QR Code ครั้งแรกในการสร้าง QR? วิธีสร้าง QR Code: ทีละขั้นตอน ครอบคลุมกระบวนการครั้งแรกทั้งหมด
การทดสอบของเราในสถานการณ์จริง
ในการพบปะนักพัฒนา เราแจกป้ายชื่อ 40 อันที่มี QR code profile ขนาด 25 มม. มุมล่าง หมึกเข้มบนพื้นขาว ตลอดงาน เราถามผู้สวมป้ายชื่อ 25 คนว่าได้รับกี่ครั้ง: 19 คนรายงานว่าการสแกนสำเร็จอย่างน้อยหนึ่งครั้ง และทุกความล้มเหลวที่เราวินิจฉัยได้ย้อนกลับไปที่ป้ายชื่อที่ถือแบนและไกล ไม่ใช่สัญลักษณ์ ชุดโค้ดเดียวกันสแกนได้ 40 จาก 40 จาก 20 ถึง 60 ซม. บนโทรศัพท์ทดสอบ รูปแบบความล้มเหลวคือเรขาคณิต ไม่ใช่สัญลักษณ์: เอียงป้ายชื่อเข้าหากล้องและมันทำงาน