Nimble 是基于 Nim 语言的轻量级异步并发框架，核心作用是用协程方式写异步代码，不用手动管理线程池，适合网络请求、IO 密集型任务，相比原生 Nim 异步写法，Nimble 封装更简洁，注意很多新手容易混淆，Nimble 同时也是 Nim 官方包管理器，本篇分两部分讲解，先讲 Nimble 包管理器基础用法，再讲 Nimble 异步并发框架的代码写法，原因是网上搜索 nimble 怎么用，绝大多数人实际是想学习 Nim 包管理器，少部分是异步协程库。
一 Nimble 包管理器 基础使用（最常用）
Nimble 是 Nim 语言自带的包管理工具，安装 Nim 编译器之后就自带 nimble 命令，用来安装第三方库、创建项目、编译项目、发布包。
常用命令对照表
| 命令 | 作用 | 示例 |
|---|---|---|
| nimble install 包名 | 安装第三方依赖包 | nimble install httpclient |
| nimble init | 新建 Nim 项目，自动生成 nimble.json 配置文件 | 在空文件夹执行 nimble init |
| nimble build | 读取 nimble.json，编译项目 | nimble build |
| nimble run | 编译并且直接运行项目主程序 | nimble run |
| nimble test | 执行项目单元测试 | nimble test |
| nimble uninstall 包名 | 卸载已经安装的包 | nimble uninstall 包名 |
| nimble list | 列出本机已经安装全部包 | nimble list |
| nimble search 关键词 | 在线搜索包仓库里面的包 | nimble search async |
详细操作步骤
第一步 确认环境，打开终端，输入 nimble --version，能输出版本号，代表 Nim 环境已经装好，如果提示找不到命令，说明 Nim 编译器没有正确配置环境变量。
第二步 创建新项目，新建空白文件夹，终端进入这个目录，执行 nimble init，向导会让你填写项目名称、版本、作者、依赖，确认之后自动生成 nimble.json。
第三步 添加依赖，编辑 nimble.json，在 dependencies 字段填入需要的库和版本，也可以直接执行 nimble install 包名 自动写入依赖。
第四步 编译运行，写完主源码 main.nim 之后，执行 nimble build 完成编译，生成可执行文件，想直接运行就用 nimble run。
第五步 测试发布，写好 tests 目录单元测试，执行 nimble test，测试全部通过之后，就可以把项目推送到 Nim 官方包仓库供其他人安装。
二 Nimble 异步协程框架 代码使用
如果你指的是 Nim 异步协程库 nimble，核心原理是协程调度，用 spawn 创建协程，wait 等待协程完成，适合 IO 并发，比如同时发起多个网络请求。
最小示例代码
import nimble
proc taskA(): string =
result = "任务A完成"
proc taskB(): string =
result = "任务B完成"
when isMainModule:
let a = spawn taskA()
let b = spawn taskB()
echo wait(a)
echo wait(b)
代码讲解
1 import nimble 导入框架模块
2 spawn 启动协程，不会阻塞主程序，多个 spawn 可以并发执行
3 wait 等待协程返回结果，拿到协程输出值
4 适合网络 IO、文件读写这类等待型任务，CPU 密集任务不推荐协程，收益很低
进阶常用操作
- 批量并发任务：把多个协程放到 seq 集合，循环 spawn，最后统一 wait 全部任务
- 超时控制：搭配 timeout 参数，协程等待超时自动退出，防止任务卡死
- 异常捕获：协程内部异常可以在 wait 阶段捕获，需要提前在协程内部加 try except
深度拓展要点
第一 区分概念坑点，绝大多数教程说的 nimble，默认就是 Nim 包管理器，不是异步库，很多初学者搜 nimble 怎么用，混淆两个同名项目，一定要确认自己要的是包管理还是协程框架。
第二 nimble.json 配置文件，是项目核心配置，里面包含项目元信息、依赖版本、编译参数，版本号建议锁定，避免升级依赖之后代码编译报错。
第三 国内网络问题，nimble 在线安装包的时候，默认拉取官方源，网络慢或者超时，可以配置镜像源，这个是高频报错原因。
第四 编译模式，nimble build 默认和 nimc 编译参数一致，可以在 nimble.json 里面自定义编译 flags，比如优化等级、调试开关。
第五 权限问题，Linux macOS 执行 nimble install 全局安装包，部分情况需要 sudo，Windows 不需要额外权限。
常见问题
问题 1 nimble 怎么用 提示 nimble 不是内部或外部命令
回答 1 nimble 怎么用出现这个报错，代表 Nim 编译器没有安装或者环境变量 PATH 没有配置，nimble 怎么用第一步就是确认 nimble --version 可以正常执行，把 Nim 的 bin 目录加入系统环境变量之后重启终端。
问题 2 nimble 怎么用 nimble install 下载包很慢失败
回答 1 nimble 怎么用在线拉取依赖超时，是官方源网络不稳定，nimble 怎么用可以切换镜像源，或者多次重试，大依赖包建议提前缓存。
问题 3 nimble 怎么用 nimble init 之后没有生成可执行文件
回答 1 nimble 怎么用，init 只是生成项目配置文件，还需要写 main.nim 源码，之后执行 nimble build 才会编译生成可执行程序，很多新手执行 init 之后直接找 exe 文件，这个是操作误区。
【免责申明】
本文基于 Nim 语言通用版本讲解，不同版本 nimble 命令参数和异步库 API 会有改动，内容仅供学习参考，详细参数以官方文档为准。
