速查 / 常見錯誤與解決

常見錯誤與解決

編譯期錯誤

隱式窄化

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 崩潰)。

其他

Aero 文档 · 基于 Aero 1.2.0 文档整理 · MIT
SereinTeam
編譯錯誤先看行列格式:line 3 col 5 [階段] 消息
泛型函數不能 #[export]導出函數寫具體類型
Python 綁定升級 Python 報錯v1 鎖定 ABI,需重編
調試構建緩存舊改編譯器後刪 src/.aero-cache/*.exe 再 build