Lino 入门指南

Lino 是一款命令行工具，旨在加速现代、可扩展且稳健的 .NET 应用程序的创建。针对追求高生产力和先进架构标准的开发者，Lino 能生成完整的项目——从独立的微服务到模块化单体应用——并融合了 .NET 生态系统中的最佳实践。

先决条件

在安装 Lino 之前，请确保您的环境已正确配置：

✅ 安装了 .NET 9.0 SDK 或更高版本。下载 .NET
✅ 在终端中可以使用 .NET CLI。通过以下命令检查：dotnet --version
✅ 安装了 Git 进行版本控制。下载 Git
✅ 安装了 Entity Framework Core CLI 以支持迁移：dotnet tool install --global dotnet-ef
✅ 兼容 OCI 的容器环境，如 Docker Desktop 或 Podman。

平台兼容性

Lino 是跨平台的，可以在主要操作系统上使用：

✅ Windows
✅ macOS
✅ Linux

安装

Lino 作为 .NET 的全局工具进行分发。在继续之前，请确保已安装 .NET 9 SDK 或更高版本。

要安装最新版本，请运行：

dotnet tool install --global Tolitech.Lino --version 1.0.0-alpha.10

安装完成后，运行以下命令验证 Lino 是否正常工作：

lino --version

如果安装成功，终端将显示已安装的版本。

认证

安装 Lino 后，需要进行认证才能访问所有功能。

如果您已有账户，请使用以下命令登录：

lino auth login

系统将提示您输入以下信息：

用户名： 预先注册的电子邮件地址。
密码： 与账户关联的密码。

如果您还没有账户，可以通过 CLI 使用以下命令注册：

lino user register

注册时，请提供以下信息：

名字： 用户的名字。
姓氏： 用户的姓氏。
电子邮件： 也将作为登录名使用的电子邮件地址。
密码： 至少6个字符的安全密码。
确认密码： 再次输入密码以进行验证。

注册完成后，用户将自动完成认证。

语言偏好设置

默认情况下，Lino CLI 显示为英语 en，但您可以根据需要选择其他语言选项：

en | pt | es | de | fr | it | ja | ko | ru | zh

要设置新的语言，请执行以下命令：

lino preferences culture set --name culture

或者，您可以通过交互式列表选择语言，方法是执行：

lino preferences culture set

UTF-8 编码设置（可选）

为了正确显示包含特殊字符的语言（如日语、韩语、俄语或中文），请确保您的终端设置为使用 UTF-8 编码。

在 Windows PowerShell 中，通过执行以下命令调整编码：

[console]::InputEncoding = [System.Text.Encoding]::UTF8

[console]::OutputEncoding = [System.Text.Encoding]::UTF8

注意：在 Linux、macOS 和 Windows Terminal 系统中，UTF-8 通常原生支持。但是，如果在显示字符时出现问题，建议验证设置。

可用命令

Lino不断发展，不断引入新命令和新功能，以满足高质量.NET项目的需求。

要在终端中显示完整的可用命令列表，请执行：

lino

或者，您也可以执行：

lino --help

终端将显示主要命令及每个命令的简要描述，如下示例所示：

COMMANDS:
    project         负责管理项目的命令。
    service         负责管理服务的命令。
    module          负责管理模块的命令。
    entity          负责管理实体的命令。
    enumeration     负责管理枚举的命令。
    value-object    负责管理值对象的命令。
    query           负责管理查询的命令。
    command         负责管理命令的命令。
    api             负责管理API的命令。
    page            负责管理页面的命令。
    database        负责管理数据库迁移的命令。
    feature         负责管理项目功能的命令。
    user            负责管理用户的命令。
    auth            负责管理用户认证的命令。
    preferences     用于管理用户偏好的命令。

要查看任何命令的子命令及具体选项，请使用：

lino command

或者：

lino command --help

例如，查看project命令：

lino project --help

将显示：

DESCRIPTION:
    负责管理项目的命令。

EXAMPLES:
    lino project new --name MyProject
    lino project list

COMMANDS:
    new     用于创建新项目的命令。
    list    用于列出已创建项目的命令。

在下一节中，我们将学习如何使用Lino快速创建一个新项目。

快速入门

使用以下命令快速创建一个现代化、可扩展并适用于大型项目的 .NET 应用程序：

lino project new --name MyApp

此命令生成一个.NET 解决方案，该解决方案具有清晰的层次责任分离，作为构建强大且可扩展的企业级应用程序的理想基础。

MyApp/
├── MyApp.sln
├── src/
│   ├── Aspire/
│   │   ├── AppHost/
│   │   │   └── MyApp.AppHost.csproj
│   │   └── ServiceDefaults/
│   │       └── MyApp.ServiceDefaults.csproj
│   └── Services/
│       └── Shared/
│           ├── API/
│           │   └── MyApp.Shared.API.csproj
│           ├── Application/
│           │   └── MyApp.Shared.Application.csproj
│           ├── Domain/
│           │   └── MyApp.Shared.Domain.csproj
│           ├── Infrastructure/
│           │   └── MyApp.Shared.Infrastructure.csproj
│           └── Infrastructure.Persistence/
│               └── MyApp.Shared.Infrastructure.Persistence.csproj
└── tests/

主要优势：

✅ 符合现代架构最佳实践的分层结构。
🔧 可灵活扩展为微服务、模块化单体或传统应用。
🚀 即用型功能，如缓存、消息传递和任务调度。
🧱 稳定的基础，支持应用 领域驱动设计（DDD）、事件驱动架构（EDA） 和 SOLID 原则。
✨ 清晰、富有意见的代码，极大提高可持续开发的效率。

使用 Lino，您可以加速高质量 .NET 项目的创建，结合生产力、架构卓越性和灵活性，以支持应用程序的成长。