nolang

README

Nolang

Nolang 是一種無 GC、內存安全、語法極簡的系統級編程語言。

核心特性

• 無 GC：不依賴垃圾回收，自动安全內存管理
• 內存安全：作用域離開自動釋放，杜絕懸垂引用、內存泄漏
• 語法極簡：減少關鍵字，無冗余語法
• 行為確定性：所有操作顯式，行為可預測
• 類型推斷: 變量無需过度聲明類型
• 函數無返回值：所有結果透過參數傳遞
• 統一引用傳遞：所有參數預設為引用
• 模块系统 - 每个文件即一个独立模块
• 命名空间 - 文件夹自动對應命名空间

函數作用域變量覆蓋

在函數作用域內，如果重複使用相同的變量名進行賦值，Nolang 將其視為覆蓋重賦值，而非創建新的棧變量。不触发变量遮蔽 如果类型不同，语法不允许

統一引用傳遞模型

Nolang 採用統一引用傳遞模型，所有函數參數預設均為引用型別。這意味著：

• 函數內修改 = 外部變量直接改變
• 函數內對參數的任何修改，都會直接作用於調用方的原始數據
• 可修改，但不可销毁

內存安全機制

• 變數自動銷毀 函數結束自動銷毀所有內部變數
• 禁止手動釋放 避免誤刪導致的懸垂引用
• 值複製容器 數組 / 切片存副本，與原變數分離， 原變量生命周期結束並銷毀時，容器內的數據不受任何影響
• 無 GC、無分配隱藏成本

docs

Usage

vscode 插件

vscode

安裝nolang cli

nolang

CLI 命令

命令	說明
no init	初始化倉庫
no new <name>	建立新倉庫
no fmt [-w] [-d] <file|dir>	格式化源代碼
no build [-o <file>] [-cc <s>] [-target <s>] [<file|dir>]	構建（輸出 executable）
no run [-cc <s>] [-target <s>] [<file|dir>]	構建並執行 main.no
no test [-cc <s>] [-target <s>] [<file|dir>]	執行測試
no add <pkg>	添加依賴
no remove <pkg>	移除依賴
no update <pkg>	更新依賴
no update-all	更新所有依賴
no list	列出依賴
no sync	同步依賴
no install [-u] [<pkg>@<version>]	安裝 binary（~/.nolang/bin/ + 軟鏈接）
no uninstall <name>	移除 binary 及軟鏈接
no pub --token <token> [--registry <url>]	發布至 registry

# 構建（默認 main.no 開始）
no build                    # 構建當前目錄
no build main.no            # 構建指定文件
no build -o output          # 指定輸出路徑
no build -cc zig            # 使用 Zig 編譯器
no build -target x86_64-linux-gnu  # 交叉編譯（指定目標平台）

# 運行（構建 + 執行）
no run                    # 構建並執行 main.no（必須有 main.no）
no run -cc zig
no run -target aarch64-macos-gnu

# 測試（構建 + 執行）
no test                   # 測試`test`目錄下所有 .no 文件
no test test/my-test.no        # 執行單個測試文件
no test -cc zig
no test -target x86_64-windows-gnu

創建新項目

no new test1

cd test1

no run

入口規則

• main.no — 程序入口
• lib.no — 庫入口，導出函數
• test/ 目錄下所有 .no 文件 — 包含測試斷言

测试说明

• 测试文件统一放在 test/ 目录下
• 每个测试文件独立构建
• 若任一测试失败，返回非零退出码

---

TODO