现代化企业级架构要求开发工具链具备极高的确定性与平台一致性。BitzOrcas.Modern 构建于 .NET 10 LTS 与 C# 14 之上，深度依赖 Roslyn 增量源生成器（Source Generators）与 Native AOT 静态分析，同时前端管理端采用 React 19 + Vite 8 + Yarn 4.17.0 单仓架构。

在拉取代码前，开发机必须具备完整的跨平台工具链支持。

开发环境工具链拓扑

第一步：按操作系统安装基础工具链

选项 A：macOS (推荐基于 Homebrew)

在 macOS 终端中执行以下命令，完成全套开发工具链的标准化装配：

# 1. 安装 .NET 10 SDK
brew install --cask dotnet-sdk

# 2. 安装 Node.js 22 LTS
brew install node@22

# 3. 启用 Corepack 激活工程内置的 Yarn 4.17.0 Berry
corepack enable

# 4. 安装 Docker 容器引擎 (推荐原生 Docker Desktop 或轻量快速的 OrbStack)
brew install --cask docker
# 或选择低内存占用的 OrbStack:
# brew install --cask orbstack

# 5. 注册并信任 ASP.NET Core 本地开发 HTTPS 根证书
dotnet dev-certs https --trust

选项 B：Linux (Ubuntu 24.04 LTS / Debian 12)

在 Linux 环境下配置微软官方 APT 仓库并安装工具链：

# 1. 注册 Microsoft 官方包签名密钥与 APT 源
wget https://packages.microsoft.com/config/ubuntu/24.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

# 2. 安装 .NET 10 SDK 与 C++ 本地构建依赖 (Native AOT 编译必备 clang/zlib)
sudo apt-get update && sudo apt-get install -y dotnet-sdk-10.0 clang zlib1g-dev

# 3. 安装 Node.js 22 LTS 并激活 Corepack
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
sudo corepack enable

# 4. 安装 Docker Engine 与 Docker Compose 插件
sudo apt-get install -y docker.io docker-compose-v2
sudo usermod -aG docker $USER
newgrp docker

# 5. 生成本地开发证书
dotnet dev-certs https

选项 C：Windows 11 (基于 winget 与 PowerShell)

以管理员身份启动 Windows Terminal (PowerShell) 执行：

# 1. 安装 .NET 10 SDK、Node.js LTS 与 Docker Desktop
winget install Microsoft.DotNet.SDK.10 --accept-source-agreements --accept-package-agreements
winget install OpenJS.NodeJS.LTS --accept-source-agreements --accept-package-agreements
winget install Docker.DockerDesktop --accept-source-agreements --accept-package-agreements

# 2. 激活 Corepack 并信任 HTTPS 本地证书
corepack enable
dotnet dev-certs https --trust

第二步：工具链版本断言验证

在继续下一步之前，请在当前终端中逐行执行版本核查命令，确保所有核心命令可被全局解析且满足最低版本要求：

# 1. 验证 .NET SDK (版本主号必须 >= 10.0)
dotnet --version

# 2. 验证 Node.js 运行环境 (主号建议为 v22.x)
node --version

# 3. 验证 Yarn 包管理器 (进入仓库后将由 Corepack 自动接管为 Yarn 4.17.0)
yarn --version

# 4. 验证 Docker 守护进程与 Compose 插件
docker --version
docker compose version

控制台输出应当类似于：

10.0.100
v22.12.0
4.17.0
Docker version 27.0.3, build 7d4bed8
Docker Compose version v2.28.1

第三步：IDE 推荐与生产力插件配置

1. JetBrains Rider（首选推荐）

BitzOrcas.Modern 仓库根目录内嵌了 .editorconfig 与 BitzOrcas.Modern.sln.DotSettings：

原生支持：对 Roslyn Source Generator 增量生成的代码树拥有极佳的跳转与实时高亮支持；
必备插件：
- Database Navigator / Database Tools：用于直连 SQL Server 1433 端口；
- Tailwind CSS：用于前端 frontend/ 样式智能感知。

2. Visual Studio 2026 / 17.12+

勾选工作负载：ASP.NET 和 Web 开发、.NET 桌面开发；
在单个组件中勾选：.NET 10.0 运行时、适用于 Windows 的 C++ (v143) 工具集（若需要本地执行 Native AOT 发布）。

3. Visual Studio Code

官方扩展：C# Dev Kit (ms-dotnettools.csdevkit)；
前端扩展：ESLint、Tailwind CSS IntelliSense。