速查 / 常見錯誤與解決
常見錯誤與解決
編譯期錯誤
隱式窄化
let x = 1; // i64
let y: i32 = x; // 錯誤:i64 不能塞進 i32解決:字面量可直接註解 i32;變量則需要顯式轉換或改用 i64。
數字當布爾條件
if (x) { } // 錯誤:x 是數字不是 bool解決:寫 if (x != 0)。
函數定義嵌套
fn outer() {
fn inner() {} // 錯誤:不允許嵌套
}解決:所有函數都是頂層定義。
重複聲明同名變量
let x = 1;
let x = 2; // 錯誤:當前作用域重複聲明運行時陷阱
Vec 越界訪問
原生 Vec 無邊界檢查,get(-1) / set(i, v)(i ≥ len)是未定義行為,可能區段錯誤(0xC0000005)。
解決:訪問前自己檢查索引範圍。
深度遞歸棧溢出
5 萬層遞歸會棧溢出(0xC00000FD),丟失緩衝輸出。
解決:遞歸函數必須有終止條件,避免無限遞歸。
忘記 str_free
運行時分配的字串(int_to_str / substr / 變量拼接)不釋放會泄漏。
match 萬用字元分支
match 分支含萬用字元 _ 或綁定模式且不在最後位置時,要保證分支後不再生成後續指令(避免非法 LLVM IR 崩潰)。
其他
| 編譯錯誤先看行列 | 格式:line 3 col 5 [階段] 消息 |
| 泛型函數不能 #[export] | 導出函數寫具體類型 |
| Python 綁定升級 Python 報錯 | v1 鎖定 ABI,需重編 |
| 調試構建緩存舊 | 改編譯器後刪 src/.aero-cache/*.exe 再 build |