moon fmt --check
moon info
for target in native wasm wasm-gc js; do
moon check --target "$target" --deny-warn
moon test --target "$target" --deny-warn
done
for target in native wasm js; do
moon check src-async --target "$target" --deny-warn
moon test src-async --target "$target" --deny-warn
done
for example in basic console_basic config_build presets text_formatter style_tags file_rotation async_basic; do
moon run "examples/$example" --target native
done
native 集成测试会写入仓库内的 logs/;文件轮转示例会在工作目录生成 bitlogger-example.log 及轮转备份,因此这两个目录需要可写。完整 CI 流程见 ci.yml。0.11.2 已在 Linux x86_64 上用固定工具链执行上述检查;native/js/wasm 完整测试为 320/312/312,异步包为 115/108/108,wasm-gc 的同步测试为 204。wasm-gc 不执行异步包测试;macOS/Windows 验证由 CI 提供。
0.9.2 - 2026-11-03
开发和 MoonBit CI 工具链更新到编译器 0.10.19+97801ee1b、CLI 0.1.20261029。
BitLogger
BitLogger 是一个使用 MoonBit 编写的结构化日志库,适合命令行工具、服务和需要统一日志输出的项目。
从第一个日志到扩展能力
BitLogger 的文档按使用路径组织:先完成一个可运行的日志输出,再按需进入文件、配置、异步和组合能力。API 文档保留为精确参考,不需要从 API 文件名开始阅读。
1. 安装
从一个空项目开始:
2. 写入第一条结构化日志
在应用 package 的
moon.pkg中导入库:然后在
main.mbt中创建控制台 logger:运行
moon run后,记录会携带 level、target、message 和 fields。下一步按实际需求选择:支持情况
BitLogger当前在 CI 中检查/验证的目标是native、wasm、js、wasm-gcsrc-async及其utils只支持native、wasm、js;wasm-gc仅提供同步src日志。上游moonbitlang/async@0.22.9未实现 wasm-gc 运行时。旧 CI 的 wasm-gc 异步测试未实际执行,现已修正支持声明。llvm目前按实验性目标处理,当前环境未完成验证native_files_supported()src-async可用,但示例examples/async_basic目前仍按 native 入口提供主要能力
build_logger(...)、build_async_logger(...)src-asyncpackagesrc-async.file_sink_async(...) -> AsyncFileSink;配置构建器及 parse/build 变体通过AsyncRuntimeSink包装配置生成的同步运行时状态,并在异步文件路径中使用异步文件后端。根src.file_sink(...) -> FileSink是同步 API。trace_id、span_id、trace_flags、trace_state,再绑定为字段文档
仓库内的
examples/目录与 Examples 文档一一对应;文档解释选择、前提、运行命令和后续扩展,源码保持为可执行参考。开发
本地开发与 CI 由
.moonbit-toolchain固定工具链归档0.10.20+65efd5b93,安装对应的编译器、CLI 和 core:moonc v0.10.20+65efd5b93 (2026-11-05)、moon 0.1.20261104。CLI 与编译器版本号不同;归档不可用时安装失败,不回退到 latest。在仓库根目录安装:
Windows 的 PowerShell 安装使用同一归档:
native 构建需要 C 工具链;Windows CI 使用 MSYS2 UCRT64 GCC 和 OpenSSL。依赖使用
moonbitlang/async@0.22.9、moonbit-community/opentelemetry@0.1.8、moonbitstack/moonyaml@0.1.7与sujy123456/lunasieve@0.1.0;显式约束moonbitlang/protobuf@0.2.0,使 OpenTelemetry 的传递依赖也使用最新发布版本。异步 native 测试和示例按现有 CI 在 Linux/macOS 运行。在安装完成的 Bash 环境中执行主要验证;js 测试需要 Node.js,wasm/wasm-gc 测试使用随工具链安装的 moonrun:
native 集成测试会写入仓库内的
logs/;文件轮转示例会在工作目录生成bitlogger-example.log及轮转备份,因此这两个目录需要可写。完整 CI 流程见 ci.yml。0.11.2 已在 Linux x86_64 上用固定工具链执行上述检查;native/js/wasm 完整测试为 320/312/312,异步包为 115/108/108,wasm-gc 的同步测试为 204。wasm-gc 不执行异步包测试;macOS/Windows 验证由 CI 提供。0.9.2 - 2026-11-03
0.10.19+97801ee1b、CLI0.1.20261029。moonbitlang/async@0.22.4;公开 API、日志行为和目标支持范围不变。0.9.1 - 2026-10-27
0.10.17+d971670cd,对应 CLI0.1.20261023;第三方依赖版本不变。Json(value),兼容新工具链且保持 UInt64 的字符串表示不变。