安装

这一页只解决一件事：让你确认本机可以编译和运行 Zeus 示例。

你需要准备什么

工具	用途	怎么确认
.NET 8 SDK	编译 Zeus 和你的应用	`dotnet --version` 能看到 `8.x.x`
Git	克隆源码	`git --version` 能输出版本
Visual Studio 2022 / Rider	做 WinForms 或 WPF 时更方便	能创建 `net8.0-windows` 项目

只跑控制台示例时，不需要真实串口、不需要仪表、不需要 USB 转串口。

方式一：先跑源码示例

这是第一次接触 Zeus 时最推荐的方式。

git clone https://github.com/Mokode-dev/Zeus.git
cd Zeus/code
dotnet test Zeus.sln
dotnet run --project samples/Zeus.Samples.Console.Headless

如果一切正常，你会看到类似输出：

通道 meter 状态：Open
收到回显：PING
宿主已停止。把复杂留给 Zeus，把简单留给用户。

这说明三个基础环节已经正常：项目能编译、宿主能启动、通道能收发。

方式二：在你的项目里装 NuGet 包

如果你已经有自己的项目，直接安装需要的包。

控制台或服务程序：

dotnet add package Zeus.Communications --prerelease

WinForms：

dotnet add package Zeus.Communications --prerelease
dotnet add package Zeus.Presentation.WinForms --prerelease

WPF：

dotnet add package Zeus.Communications --prerelease
dotnet add package Zeus.Presentation.Wpf --prerelease

Modbus：

dotnet add package Zeus.Protocols.Modbus --prerelease

当前版本是 0.1.0-preview，所以必须加 --prerelease。更完整的包说明见 NuGet 预览包。

方式三：源码项目引用

如果你在本仓库里开发示例或调试 Zeus 本身，使用项目引用。

<ItemGroup>
  <ProjectReference Include="..\..\src\Zeus.Communications\Zeus.Communications.csproj" />
  <ProjectReference Include="..\..\src\Zeus.Presentation.WinForms\Zeus.Presentation.WinForms.csproj" />
</ItemGroup>

不要同时对同一个 Zeus 程序集使用 NuGet 包和源码项目引用，避免版本混用。

跑更多示例

在 code 目录执行：

dotnet run --project samples/Zeus.Samples.WinForms.QuickStart
dotnet run --project samples/Zeus.Samples.Wpf.QuickStart
dotnet run --project samples/Zeus.Samples.Console.Config
dotnet run --project samples/Zeus.Samples.Console.Modbus

WinForms / WPF 示例会打开窗口。点击“发送”后，虚拟通道会把文本回显到界面上。

常见问题

现象	最可能原因	处理
`dotnet` 命令不存在	没装 .NET SDK，或 PATH 未刷新	安装 .NET 8 SDK 后重新打开终端
看到 `7.x.x` 或更低版本	装的是旧 SDK	安装 .NET 8 SDK
找不到 Zeus 预览包	没加 `--prerelease`	重新执行带 `--prerelease` 的命令
WinForms / WPF 包还原失败	项目不是 Windows 目标框架	把目标框架改成 `net8.0-windows`
示例能编译但串口打不开	真实端口不存在或被占用	先跑虚拟通道示例，再看串口

下一步：控制台示例。

你需要准备什么​

方式一：先跑源码示例​

方式二：在你的项目里装 NuGet 包​

方式三：源码项目引用​

跑更多示例​

常见问题​