對應(yīng)moonc版本：v0.8.0

一、MoonBit 0.8.0發(fā)布

我們很高興正式發(fā)布MoonBit 0.8.0。MoonBit是一門AI原生的編程語言，它的主要特點(diǎn)是高可靠，易讀和高性能。這是 MoonBit 邁向穩(wěn)定、可用于生產(chǎn)環(huán)境的重要里程碑版本。

這次發(fā)布并非一系列零散改動(dòng)的簡單集合。MoonBit 0.8 標(biāo)志著項(xiàng)目從實(shí)驗(yàn)性語言，明確邁入工程級(jí)語言與工具鏈階段：在調(diào)試能力、錯(cuò)誤處理、包管理以及開發(fā)者工具等方面都有了顯著提升，尤其更適合支撐大規(guī)模代碼庫和以 Agent 為核心的開發(fā)工作流。

為什么 MoonBit 0.8 很重要？

正如許多開發(fā)者所觀察到的，Rust 通過其嚴(yán)格的語義和可驗(yàn)證性，為 AI 輔助開發(fā)提供了堅(jiān)實(shí)的基礎(chǔ)。MoonBit 在繼承類似可靠性目標(biāo)的同時(shí)，更加注重顯著更快的編譯速度（在實(shí)際使用中通常比rust快一個(gè)到兩個(gè)數(shù)量級(jí)），以及面向 Agent工作流深度集成的開發(fā)工具體系。

隨著 0.8 版本的發(fā)布，這些設(shè)計(jì)目標(biāo)已不再停留在抽象理念層面，而是在語言、編譯器、運(yùn)行時(shí)以及IDE等各個(gè)層面得到一致體現(xiàn)。

重點(diǎn)更新：

WasmGC/LLVM/Native后端Backtrace 支持

MoonBit 的 WasmGC/native/LLVM 后端現(xiàn)支持在程序崩潰時(shí)，自動(dòng)打印崩潰處的調(diào)用棧。并且能直接輸出對應(yīng)的 MoonBit 源碼的位置，極大改善了調(diào)試體驗(yàn)（以下是Native后端的調(diào)用棧示例）：

RUNTIME ERROR: abort() called
/path/to/moonbitlang/core/array/array.mbt:187 at @moonbitlang/core/array.Array::at[Int]
/path/to/pkg/main/main.mbt:3 by @username/hello/out_of_idx.demo
/path/to/pkg/main/main.mbt:9 by main

AI 原生的面向 specification 支持

MoonBit 新增了declare關(guān)鍵字，可以用于聲明需要實(shí)現(xiàn)的類型、函數(shù)、方法等。如果declare的聲明沒有對應(yīng)的實(shí)現(xiàn)，MoonBit 編譯器會(huì)報(bào)一個(gè)警告。declare關(guān)鍵字提供了面向 AI 的原生 specification 支持：可以用declare的形式指定需要 AI 實(shí)現(xiàn)的接口，并根據(jù)接口提前編寫測試。只需要把declare和測試所在的文件標(biāo)記為只讀，就能防止 AI “作弊”。隨后，MoonBit 編譯器的警告信息能輔助 AI 正確地實(shí)現(xiàn)所有必要的接口。由于沒有實(shí)現(xiàn)declare只是一個(gè)警告，AI 可以漸進(jìn)式地編寫、測試代碼。

社區(qū)動(dòng)向：

? MoonBit 社區(qū)正在在快速增長，目前核心用戶數(shù)接近20萬（以插件下載為統(tǒng)計(jì)指標(biāo)），生態(tài)包的數(shù)量達(dá)到4295 個(gè)，并且最近幾周增速都超過 10%。

? MoonBit 軟件工廠受到關(guān)注：，我們正在發(fā)起 「，期待社區(qū)用戶可以做出優(yōu)質(zhì)的大型軟件。

? 我們持續(xù)，特別期待擁有多語言背景的國際地區(qū)大使。

二、0.8更新正式內(nèi)容

語言更新

1.suberror Err PayloadType語法被廢棄

用戶需要將這種定義修改成類似enum的形式：

suberror Err {
  Err(PayloadType)
}

這一改動(dòng)的動(dòng)機(jī)是suberror Err PayloadType語法容易產(chǎn)生Err和PayloadType有相同 ABI 的誤解，但實(shí)際上 error type 都有自己特殊的 ABI。這一改動(dòng)可以通過moon fmt自動(dòng)完成遷移

2. 廢棄了推導(dǎo)內(nèi)建 error 構(gòu)造器（目前主要是Failure）的行為。

類型未知時(shí)，需要將raise Failure(..)替換成raise Failure::Failure(..)，catch時(shí)同理

3. 支持了在 MoonBit 中直接調(diào)用FuncRef[_]類型的值。

這一功能可以用于在 native 后端實(shí)現(xiàn)動(dòng)態(tài)加載函數(shù)或 JIT

4. WasmGC/LLVM/Native 后端Backtrace 支持

現(xiàn)在，使用wasm-gc, native后端或者llvm后端時(shí)，如果觸發(fā)panic，例如數(shù)組下標(biāo)越界，對為None的Option[T]進(jìn)行unwrap，try!一個(gè)會(huì)拋出錯(cuò)誤的函數(shù)，或者手動(dòng)調(diào)用panic函數(shù)時(shí)，在debug模式下會(huì)打印出調(diào)用棧，例如下方的函數(shù)：

fn demo(a: Array[Int], b: Array[Int]) -> Unit {
  let _ = a[1]
  let _ = b[2]
}


 fn main {
  let a = [1, 2]
  let b = [3]
  demo(a, b)
}

以native后端為例，使用moon run main --target native，將會(huì)看到下面的調(diào)用棧：

RUNTIME ERROR: abort() called
/path/to/moonbitlang/core/array/array.mbt:187 at @moonbitlang/core/array.Array::at[Int]
/path/to/pkg/main/main.mbt:3 by @username/hello/out_of_idx.demo
/path/to/pkg/main/main.mbt:9 by main

注：目前Windows系統(tǒng)上native和LLVM后端暫不支持此項(xiàng)功能。

5.新增了declare關(guān)鍵字，用于替代原本的#declaration_only屬性。declare新增了 trait 實(shí)現(xiàn)的支持。比如：

declare type T // declare a type to be implemented
declare fn T::f(x : T) -> Int // declare a method to be implemented


 struct S(Int)
declare impl Show for S // declare an impl relation

declare impl和直接寫impl的主要區(qū)別在于declare impl在缺少 implementation 的情況下只會(huì)報(bào)警告，不影響代碼執(zhí)行，所以可以跑其他功能的測試。

6. 新增了反向的 range 表達(dá)式x>..y和x>=..y

用于在for .. in循環(huán)中進(jìn)行反向的迭代：

///|
test "reversed range, exclusive" {
  let result = []
  for x in 4>..0 {
    result.push(x)
  }
  debug_inspect(result, content="[3, 2, 1, 0]")
}


 ///|
test "reversed range, inclusive" {
  let result = []
  for x in 4>=..0 {
    result.push(x)
  }
  debug_inspect(result, content="[4, 3, 2, 1, 0]")
}

為了讓語法更一致，正向的兩側(cè)閉合的 range 表達(dá)式的語法從x..=y遷移至x..<=y。這一改動(dòng)可以通過moon fmt自動(dòng)遷移

7. 禁用了在外部使用{ ..old_struct, field: .. }語法更新一個(gè)帶有priv字段的結(jié)構(gòu)體的行為

8.lexmatch表達(dá)式 first match 下新增 guard 支持。

包含 guard 的 lexmatch 性能會(huì)有損失，因此推薦在快速開發(fā)過程中使用，之后再考慮是否改寫。其語法和 match 表達(dá)式中的 guard 一致

查看 https://github.com/moonbitlang/lexmatch_spec 了解更多：

lexmatch input {
  ("#!" "[^\n]+") if allow_shebang => ...
  ...
}

9.struct新增了自定義構(gòu)造器的支持，語法如下：

struct S {
  x : Int
  y : Int

   // 為 `struct` 聲明一個(gè)構(gòu)造器
  fn new(x~ : Int, y? : Int) -> S
}

 // 實(shí)現(xiàn) `struct` 的構(gòu)造器
fn S::new(x~ : Int, y? : Int = x) -> S {
  { x, y }
}

 // 使用 `struct` 的構(gòu)造器
test {
  let s = S(x=1)
}

語義上：

?struct中聲明fn new即可給這個(gè)struct定義自動(dòng)構(gòu)造器。除了必須返回struct自身之外，自定義構(gòu)造器的簽名沒有其他限制?？梢允褂?optional argument、拋出錯(cuò)誤等。struct中的fn new(..)的參數(shù)不能寫默認(rèn)值，但可以省略參數(shù)名字

? 對于有類型參數(shù)的struct，fn new可以特化類型參數(shù)，也可以給類型參數(shù) 添加trait約束。語法和普通的頂層函數(shù)聲明一樣

? 如果在struct中聲明了fn new， 則必須定義一個(gè)方法fn S::new來實(shí)現(xiàn)這個(gè)構(gòu)造器。S::new的簽名必須和struct中的fn new完全相同

? 使用struct構(gòu)造器的方式和使用一個(gè)enum構(gòu)造器完全一樣。比如，在類型已知的時(shí)候，可以直接寫S(..)，無需寫成@pkg.S(..)或 者@pkg.S::S(..)。不過，struct的構(gòu)造器不能用于模式匹配

?struct構(gòu)造器的可見性和struct字段相同。也就是說，pub struct和pub(all) struct的構(gòu)造器可以在當(dāng)前包外調(diào)用 ，struct和priv struct的構(gòu)造器則是私有的

10.using聲明上現(xiàn)在可以添加標(biāo)注來廢棄using創(chuàng)建的別名。

11. 增加了Debug特征和自動(dòng) derive 相關(guān)支持。

///|
struct Data {
  pos : Array[(Int, Int)]
  map : Map[String, Int]
} derive(Debug)


 ///|
test "pos" {
  debug_inspect(
    {
      pos: [(1, 2), (3, 4), (5, 6)],
      map: { "key1": 100, "key2": 200, "key3": 300 },
    },
    content=(
      #|{
      #|  pos: [(1, 2), (3, 4), (5, 6)],
      #|  map: {
      #|    "key1": 100,
      #|    "key2": 200,
      #|    "key3": 300,
      #|  },
      #|}
    ),
  )
}

Debug 特征是Show 特征的改進(jìn)版本，用于提供更結(jié)構(gòu)化和可讀的打印信息。

derive(Debug) 支持額外的 ignore 參數(shù)，它接受一個(gè)或者多個(gè)類型構(gòu)造器名。在實(shí)現(xiàn)類型本身的打印邏輯時(shí)，它會(huì)過濾語法上相同的類型構(gòu)造器，相關(guān)部分將會(huì)打印成...。 這在內(nèi)部類型來自第三方包，并且沒有提供 Debug 特征的實(shí)現(xiàn)時(shí)非常有用。

///|
struct Data1 {
  field1 : Data2
  field2 : Double
  field3 : Array[Int]
} derive(Debug(ignore=[Data2, Array]))

 ///|
struct Data2 {
  content : String
}

 ///|
test "pos" {
  debug_inspect(
    { field1: { content: "data string" }, field2: 10, field3: [1, 2, 3] },
    content=(
      #|{
      #|  field1: ...,
      #|  field2: 10,
      #|  field3: ...,
      #|}
    ),
  )
}

@moonbitlang/core/debug包還提供了專門的assert_eq(a,b)，在斷言失敗時(shí)，找出 a 和 b 的差異并打印在命令行中。

在未來我們將逐步遷移到Debug并棄用derive(Show)，Show 特征則專注于手動(dòng)實(shí)現(xiàn)特殊的打印邏輯，如Json::stringify。

12. 移除了將帶參數(shù)的構(gòu)造器直接當(dāng)作高階函數(shù)使用的行為，如果需要把構(gòu)造器用作高階函數(shù)，需要寫一個(gè)匿名函數(shù)：

test {
  let _ : (Int) -> Int? = Some // 已被移除
  let _ : (Int) -> Int? = x => Some(x) // 正確的寫法
  let _ : Int? = 42 |> Some // 管道不受影響
}

這一行為之前已通過警告的形式廢棄。注意管道運(yùn)算符右側(cè)依然可以直接寫構(gòu)造器，不受影響

13. 廢棄了fn上的副作用推導(dǎo)。

如果一 個(gè)fn實(shí)際上可能拋出錯(cuò)誤或者調(diào)用async函數(shù)，就必須加上raise/async標(biāo)記，否則編譯器會(huì)報(bào)一個(gè)警告。箭頭函數(shù)語法(..) => ..不受影響。因此，未來對于回調(diào)函數(shù)類的匿名函數(shù)，建議使用箭頭函數(shù)而非fn。fn可以在需要顯式標(biāo)注以改善可讀性的時(shí)候使用

14. 調(diào)整了x..f()的語義，將其調(diào)整回最簡單的語義：x..f()等價(jià)于{ x.f(); x }。

之前，x..f()表達(dá)式的結(jié)果（x）可以被直接忽略。現(xiàn)在，編譯器會(huì)對這種情況報(bào)一個(gè)警告，需要把最后一個(gè)..f()替換成.f()或者顯式忽略結(jié)果

15. 循環(huán)的else塊關(guān)鍵字改為nobreak

for/foreach/while 循環(huán)中此前可以用elseblock 來寫明在循環(huán)正常退出時(shí)的計(jì)算結(jié)果為了更加直觀，這一關(guān)鍵字被改成了nobreak，比如：

fn f() -> Int {
  for i = 0; i < 10; i = i + 1 {


   } nobreak {
    i
  }
}

這一改動(dòng)可以使用moon fmt自動(dòng)遷移

16. 新增了一個(gè)默認(rèn)關(guān)閉的警告unnecessary_annotation

它會(huì)標(biāo)記出代碼中的結(jié)構(gòu)體字面量和構(gòu)造器上不必要的類型標(biāo)注，即那些編譯器可以通過上下文推斷出正確的類型、無需顯式指定類型的代碼

工具鏈更新

1. 正式啟用 moon.pkg 。

在對 moon.pkg 進(jìn)行了一段時(shí)間的測試和改進(jìn)后，我們正式啟用了 moon.pkg。舊的項(xiàng)目在執(zhí)行 moon fmt 時(shí)將會(huì)被自動(dòng)遷移到新的格式。新的項(xiàng)目也會(huì)直接使用 moon.pkg 作為包的配置。下面是常用配置的例子：

import {
  "path/to/pkg1",
  "path/to/pkg2" @alias,
}


 warnings = "+deprecated-unused_value"

更多詳細(xì)信息請見 moonbit 語言文檔。

2.moon test支持通過-j參數(shù)并行地運(yùn)行測試。

3.moon test支持通過--outline列出所有待運(yùn)行的測試。

4.moon test --index支持指定特定范圍的測試（左閉右開）

如moon test --index 0-2會(huì)運(yùn)行前兩個(gè)測試（--index需事先指定測試的文件）。

5.moon install的 支持從 MoonBit 項(xiàng)目全局安裝可執(zhí)行程序

因?yàn)?code>moon check與moon build都可以自動(dòng)安裝依賴。

moon install 的新行為類似cargo install或go install，支持用戶從包管理平臺(tái)、git 源或者本地安裝一個(gè)或多個(gè)二進(jìn)制文件到全局（對應(yīng)包需要支持 native 后端且 is-main 為 true），如：

   moon install username/package (root 為 package 時(shí))
   moon install username/cmd/main (安裝某一個(gè)包)
   moon install username/... (前綴開始所有的包)
   moon install ./cmd/main (local path)
   moon install https://github.com/xxx/yyy.git (自動(dòng)識(shí)別 git 鏈接)

更多用法可以使用moon install --help查看。

6. 現(xiàn)在可以在 moon.pkg 中配置

regex_backend選項(xiàng)來指定 lexmatch 表達(dá)式的正則使用什么后端：

options(
  // 默認(rèn)為 "auto"，其他可選項(xiàng)分別為 "block", "table", "runtime"
  // auto 由編譯器自主決定采用哪個(gè)后端
  // block 后端性能最好，但代碼體積可能產(chǎn)生膨脹
  // table 后端生成查表解釋執(zhí)行的代碼，兼顧代碼體積和性能
  // runtime 后端生成依賴標(biāo)準(zhǔn)庫中 regex_engine 的代碼，在大量使用正則的情況下，能大幅減少生成的代碼體積
  regex_backend: "runtime",
)

7. moon -C 改為改變工作目錄

moon -C 以前會(huì)從對應(yīng)路徑開始查找 MoonBit 項(xiàng)目，但是不會(huì)改變工作目錄；這與一般構(gòu)建系統(tǒng)傳統(tǒng)不符。現(xiàn)在moon -C 會(huì)改為改變工作目錄，并且需要出現(xiàn)在任何子命令或參數(shù)前；同時(shí)添加了--manifest-path指向moon.mod.json用于運(yùn)行路徑與源代碼路徑不同的情況

8.moon run和moon build默認(rèn)使用--debug

9. 更新了.mbt.md文件在 front matter 聲明依賴的形式。

之前在 front matter 中只能聲明 module dependency，并且會(huì)將被依賴的 module 中的 package 全部導(dǎo)入，這會(huì)導(dǎo)致無法更細(xì)粒度地寫明 import 以及 package alias 會(huì)沖突的問題。在新版本中，front matter 聲明依賴的形式改成了直接寫明具體依賴的包，并且可以聲明 alias，并且需要在 module 后面寫明版本號(hào)，多次出現(xiàn)的 module 只需寫一次版本號(hào)即可，對標(biāo)準(zhǔn)庫的依賴不需要寫版本號(hào)。

---

 moonbit:

   import:

     - path: moonbitlang/async@0.16.5/aqueue

       alias: aaqueue

   backend:

     native

 ---

10.moon new簡化了模板，更新了關(guān)于 skills 的簡單介紹。

11.moon fetch提供了一個(gè)簡單的獲取已發(fā)布包源代碼的方式

默認(rèn)會(huì)保存至項(xiàng)目根目錄或當(dāng)前路徑下的.repos，方便 Agent 閱讀源代碼學(xué)習(xí)使用方式。

12.moon fmt支持保留和折疊{ statement1; statement2 }語句之間的空行。

例如：

// 格式化前
fn main {
  e()

   // comment
  f()

   g()
  h()
}

// 格式化后
fn main {
  e()

   // comment
  f()

   g()
  h()
}

13.```moonbit現(xiàn)在會(huì)被自動(dòng)格式化成```moonbit nocheck

在*.mbt.md文件或者文檔注釋中，對于被設(shè)置為跳過檢查的```moonbit代碼塊，格式化器會(huì)自動(dòng)加上更顯式的 nocheck 標(biāo)記 。

標(biāo)準(zhǔn)庫&實(shí)驗(yàn)庫 更新

1.moonbitlang/async改動(dòng)：

? 新增了@process.spawn，可以直接在一個(gè)TaskGroup中創(chuàng)建一個(gè)外部進(jìn)程，并獲取該進(jìn)程的 PID。TaskGroup在默認(rèn)狀態(tài)下會(huì)等待該外部進(jìn)程結(jié)束，在需要提前退出時(shí)會(huì)自動(dòng)中止這個(gè)外部進(jìn)程

? 新增了@fs.File::{lock, try_lock, unlock}方法，提供文件鎖的支持。普通的文件 IO 不受文件鎖的影響

? 新增了@fs.tmpdir(prefix~)，提供創(chuàng)建臨時(shí)文件夾的支持

? 新增了@async.all和@async.any，語義類似Promise.all和Promise.any

? 在examples文件夾下新增了更多簡單示例和對每個(gè)示例的介紹

2.@json.inspect遷移至json_inspect

IDE 更新

1. 優(yōu)化alias定義跳轉(zhuǎn)

查找alias定義時(shí)，現(xiàn)在除了會(huì)顯示alias定義的位置外，還會(huì)一并顯示 alias target 定義的位置：

2.moon ide hover：

moon ide新增hover子命令，用于顯示源代碼中某個(gè)符號(hào)的類型和文檔：

$ moonide hover -no-check filter -loc hover.mbt:14
test {
  let a: Array[Int] = [1]
  inspect(a.filter((x) => {x > 1}))
            ^^^^^^
            ```moonbit
            fn[T] Array::filter(self : Array[T], f : (T) -> Bool raise?) -> Array[T] raise?
            ```
            ---
             Creates a new array containing all elements from the input array that satisfy
             the given predicate function.
             Parameters:
             * `array` : The array to filter.
             * `predicate` : A function that takes an element and returns a boolean
             indicating whether the element should be included in the result.
             Returns a new array containing only the elements for which the predicate
             function returns `true`. The relative order of the elements is preserved.
             Example:
             ```mbt check
             test {
               let arr = [1, 2, 3, 4, 5]
               let evens = arr.filter(x => x % 2 == 0)
               inspect(evens, content="[2, 4]")
             }
             ```
}

3.moon ide rename:

moon ide新增rename子命令，用于生成符合codex apply_patch 工具格式的重命名patch，方便agent更準(zhǔn)確快速地重構(gòu)代碼。例如：

$ moon ide rename TaskGroup TG
*** Begin Patch
*** Update File: /Users/baozhiyuan/Workspace/async/src/async.mbt
@@
 /// and will result in immediate failure.
 ("use `async fn main` or `async test` instead")
 (target="native")
-pub fn with_event_loop(f : async (TaskGroup[Unit]) -> Unit) -> Unit raise {
+pub fn with_event_loop(f : async (TG[Unit]) -> Unit) -> Unit raise {
   @event_loop.with_event_loop(() => with_task_group(f))
 }

 *** Update File: /Users/baozhiyuan/Workspace/async/src/task_group.mbt
@@
 ///
 /// The type parameter `X` in `TaskGroup[X]` is the result type of the group,
 /// see `with_task_group` for more detail.
-struct TaskGroup[X] {
+struct TG[X] {
   children : Set[@coroutine.Coroutine]
   parent : @coroutine.Coroutine
   mut waiting : Int
@@
 pub suberror AlreadyTerminated derive(Show)

  ///|
-fn[X] TaskGroup::spawn_coroutine(
+fn[X] TG::spawn_coroutine(
-  self : TaskGroup[X],
+  self : TG[X],
   f : async () -> Unit,
...

關(guān)于 MoonBit :

MoonBit （https://www.moonbitlang.cn/）國內(nèi)首個(gè)工業(yè)級(jí)編程語言及其配套工具鏈, 由粵港澳大灣區(qū)數(shù)字經(jīng)濟(jì)研究院（簡稱“IDEA 研究院”）基礎(chǔ)軟件中心打造的AI原生的編程語言以及開發(fā)者平臺(tái)。通過創(chuàng)新框架在程序語言界形成后發(fā)優(yōu)勢，在編譯速度、運(yùn)行速度、體積大小上已成功領(lǐng)先傳統(tǒng)語言。

官方平臺(tái)賬號(hào)，歡迎掃碼關(guān)注

有任何事宜添加小助手微信

官網(wǎng)｜moonbitlang.cn

知乎｜@張宏波 / @MoonBit

小紅書｜MoonBit月兔

Twitter｜@Moonbitlang

Bilibili｜MoonBit月兔

抖音｜MoonBit月兔

MoonBit用戶交流群｜添加小助手moonbit_helper

?關(guān)注分享在看一鍵三連 ～