本文介绍 ABP Helper 的两种安装方式:在线安装 和 离线 nupkg 安装,并附常见问题解决方案。
一、安装前准备
确保环境满足以下条件:
- ✔ .NET 运行时:推荐 .NET 6 或 .NET 7(版本需匹配工具)
- ✔ 系统:Windows 10 / 11
- ✔ 命令行:PowerShell(推荐管理员运行)
👉 未安装 .NET:只需安装 Runtime(运行时),无需 SDK
二、安装方式
方式一:在线安装(推荐)
适合网络正常的情况:
dotnet tool install --global EasyAbp.AbpHelper
验证是否安装成功:
abphelper --version
方式二:离线安装(nupkg)
适合:网络差 / 指定版本
1️⃣ 下载 nupkg 包
- 最新版(需 .NET 7)
https://www.nuget.org/packages/EasyAbp.AbpHelper/0.28.0 - 低版本(支持 .NET 6)
https://www.nuget.org/packages/EasyAbp.AbpHelper/0.17.0 - 博主使用的版本
👉 下载后放入目录,如:D:\nupkg
2️⃣ 执行安装
cd D:\nupkg# 如已安装旧版本,先卸载
dotnet tool uninstall --global EasyAbp.AbpHelper# 离线安装
dotnet tool install --global --source ./ EasyAbp.AbpHelper
验证:
abphelper --version
三、常见问题
❌ 版本冲突
报错:
请求的版本低于现有版本
✅ 解决:
dotnet tool uninstall --global EasyAbp.AbpHelper
再重新安装低版本
❌ 缺少 .NET 运行时
报错:
You must install or update .NET
✅ 解决:
- 安装对应版本 .NET(推荐)
- 或降低 ABP Helper 版本(如 0.17.0)
四、快速使用示例
生成 CRUD 代码:
abphelper generate crud PopularPageAnalysis \
--separate-dto \
--skip-permissions \
--skip-db-migrations \
--skip-ui
👉 PopularPageAnalysis 换成你的实体名即可
五、总结
- 👍 网络正常:直接在线安装
- 👍 有版本/网络问题:用离线 nupkg
- ⚠ 关键点:.NET 版本必须匹配
补充:若需要可视化操作,可下载 ABP Helper GUI 版本,下载地址:https://github.com/EasyAbp/AbpHelper.GUI/releases,下载后解压运行即可,适合不熟悉命令行的开发者。