Development and Testing

开发、测试与贡献

Development, Testing, and Contribution

适用版本：4.0.0。

Applies to 4.0.0.

首页 · 性能与基准

Home · Performance and Benchmarks

本地构建

Local Build

主库、测试和语言工具都使用 .NET 项目。先还原依赖，再按需要构建对应项目。

The main library, tests, and language tools are .NET projects. Restore dependencies first, then build the project you need.

dotnet build src/AuroraScript.csproj -c Release
dotnet build language-tools/AuroraScript.Mcp/AuroraScript.Mcp.csproj -c Release
dotnet build language-tools/AuroraScript.VisualStudio/AuroraScript.VisualStudio.csproj -c Release

测试

Testing

功能测试项目多目标到 net8.0、net9.0 和 net10.0。运行对应目标前，本机必须安装相应 runtime。

The functional test project targets net8.0, net9.0, and net10.0. Install the corresponding runtimes locally before running each target.

dotnet test tests/AuroraScript.Tests/AuroraScript.Tests.csproj -c Release

新增或修改语言语义时，应同时覆盖正常路径、诊断路径、跨模块行为和可观察的边界条件。性能回归不以时间断言写入功能测试，而应通过 benchmark 检测。

When adding or changing language semantics, cover the normal path, diagnostics, cross-module behavior, and observable boundary conditions. Do not encode timing assertions in functional tests; detect performance regressions through benchmarks.

文档与 schema

Documentation and Schema

documents/ 是语言工具和 MCP 的随包语言资料。修改公开 API 或语言特性时，同步更新相应 schema、示例和 Wiki；避免仅更新 README 或仅更新代码。

documents/ is the packaged language material for tooling and MCP. When changing a public API or language feature, update the corresponding schema, examples, and Wiki together; avoid updating only a README or only code.

提交前检查

Pre-commit Checks

• 运行受影响项目的构建与测试。
• 运行相关 benchmark 或至少 --smoke，若更改位于热路径。
• 检查 Wiki 链接、版本号和 API 页面是否同步。
• 不提交 bin/、obj/、本地发布目录或机器专属配置。

• Build and test every affected project.
• Run the relevant benchmark, or at least --smoke, when changing a hot path.
• Check that Wiki links, versions, and API pages are synchronized.
• Do not commit bin/, obj/, local publish folders, or machine-specific configuration.