การติดตั้ง
ดาวน์โหลดไฟล์ ZIP สำหรับ Windows x64 แล้วแตกไฟล์ไปยังไดเรกทอรีใดก็ได้ CrucibleCpp เป็นโปรแกรมไฟล์เดียวที่ลิงก์แบบสแตติก จึงไม่ต้องติดตั้งรันไทม์
เริ่มต้นอย่างรวดเร็ว
ขั้นแรกตรวจสอบว่ามี g++.exe ใน PATH แล้วแทนที่คำสั่ง g++ -E:
ถ้าไม่ได้ใส่ GCC เป้าหมายไว้ใน PATH ให้ใช้ --gcc ระบุอย่างชัดเจน:
เลือก GCC
CrucibleCpp ใช้มาโครที่กำหนดไว้ล่วงหน้าของ GCC เป้าหมาย,__has_* ข้อมูลและเส้นทางค้นหา include อย่าใช้โปรไฟล์ของ GCC15 ไปประมวลผลล่วงหน้าส่วนหัวของ GCC14
| วิธี | พฤติกรรม |
|---|---|
--gcc-version=13|14|15 | ค้นหาคอมไพเลอร์ที่รองรับสูงสุดซึ่งตรงกับเวอร์ชันหลักใน PATH |
--gcc <g++.exe> | ใช้คอมไพเลอร์ที่ระบุโดยตรง และอ่านเวอร์ชันกับเส้นทาง include ของมัน |
| ไม่ระบุ | สแกน PATH และเลือกเวอร์ชันสูงสุดที่รองรับเป็นค่าเริ่มต้น (15 → 14 → 13) |
--gcc, อย่าพึ่งพาตัวอักษรไดรฟ์แบบตายตัวโปรไฟล์มาตรฐานที่รองรับ:
คำสั่งที่ใช้บ่อย
| พารามิเตอร์ | หน้าที่ |
|---|---|
-P | ไม่แสดง line markers |
-o <file> | ไฟล์เอาต์พุต |
-I <dir> | เพิ่มไดเรกทอรี include |
-isystem <dir> | ไดเรกทอรีส่วนหัวระบบ |
-D / -U | กำหนด / ยกเลิกมาโคร |
-include <file> | บังคับ include |
-MD -MF -MT | สร้างไฟล์การพึ่งพาของ Make/CMake |
-finput-charset / -fexec-charset | ชุดอักขระอินพุต / เอ็กซีคิวชัน |
--embed-dir <dir> | #embed ไดเรกทอรีสำหรับค้นหา |
--analysis-json <file> | แสดงกราฟ include, มาโคร trace และบันทึก PCH |
PCH
ตัว g++ -E ของ GCC ไม่ใช้ .gch; PCH ถูกใช้เฉพาะตอนคอมไพล์จริง CrucibleCpp อ่านซอร์สของส่วนหัวเป็นค่าเริ่มต้น และสามารถตรวจสอบ ลงทะเบียน และแคช PCH ที่สร้างจากภายนอกได้
เปิดใช้แคช PCH:
manifest ของแคชจะบันทึกเส้นทางคอมไพเลอร์ เวอร์ชัน แฮชของคอมไพเลอร์ และแฮชของออปชัน PCH ของ GCC13/14/15 จะไม่จับคู่ผิดต่อกัน
ไดแอกนอสติก
โดยค่าเริ่มต้นจะแสดงบรรทัดซอร์สและ caret สไตล์ GCC สามารถปิดหรือปรับได้:
รองรับ #pragma GCC diagnostic push/pop/ignored/warning/error และ #pragma GCC system_header. ส่วนหัวที่มาจาก -isystem จะระงับคำเตือนทั่วไปโดยค่าเริ่มต้น และ -Wsystem-headers สามารถแสดงกลับมาได้
การแก้ปัญหา
ไม่พบส่วนหัวของไลบรารีมาตรฐาน
คอมไพเลอร์เป้าหมายไม่ได้อยู่ใน PATH ให้ใช้ --gcc เพื่อระบุ หรือเพิ่มไดเรกทอรี bin ของมันเข้าไปใน PATH หรือจะใช้ -isystem เพื่อระบุโดยตรง
เลือกเวอร์ชัน GCC ไม่ถูกต้อง
ใช้ --gcc-version=13|14|15 เพื่อล็อกเวอร์ชันหลัก หรือใช้ --gcc เพื่อชี้ไปที่ g++.exe. อย่าใช้ target profile ปนกับส่วนหัวของอีกเวอร์ชันหนึ่ง
แคช PCH รายงาน corrupt
PCH ไม่ตรงกับคอมไพเลอร์/ออปชันปัจจุบัน หรือไฟล์เสียหาย ให้ลบรายการแคชที่ตรงกันแล้วสร้างใหม่ หรือจะปิดแคช PCH ทั้งหมดแล้วให้อ่านซอร์สของส่วนหัวก็ได้
เอาต์พุตไม่สามารถคอมไพล์ด้วย GCC
ขั้นแรกตรวจสอบให้แน่ใจว่าการประมวลผลล่วงหน้าและการคอมไพล์ใช้ GCC เวอร์ชันเดียวกันและ -std. จากนั้นคอมไพล์ “.i ที่ CrucibleCpp สร้าง” แยกต่างหาก เพื่อตรวจสอบว่าปัญหามาจากขั้นตอนการประมวลผลล่วงหน้าหรือไม่