Admin.NET支持多种操作系统进行开发：
Windows系统：
macOS系统：
Linux系统：
最低配置：
推荐配置：
| 软件 | 版本要求 | 用途 |
|---|---|---|
| .NET SDK | 6.0/7.0/8.0 | 后端开发运行环境 |
| Visual Studio 2022 / Rider | 最新版 | 后端IDE |
| Node.js | 16.x/18.x/20.x | 前端运行环境 |
| pnpm | 8.x/9.x | 前端包管理器 |
| VS Code | 最新版 | 前端IDE |
| Git | 最新版 | 版本控制 |
| MySQL/SQL Server/PostgreSQL | 见下文 | 数据库 |
| Redis | 5.x或更高 | 缓存服务（可选） |
方式一：使用安装包
# 打开PowerShell或命令提示符
dotnet --version
# 输出类似：8.0.100
dotnet --list-sdks
# 列出所有已安装的SDK版本
方式二：使用winget（Windows包管理器）
# 安装.NET 8 SDK
winget install Microsoft.DotNet.SDK.8
# 或安装.NET 6 SDK
winget install Microsoft.DotNet.SDK.6
方式三：使用Chocolatey
# 首先安装Chocolatey（如果没有）
Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
# 安装.NET SDK
choco install dotnet-sdk -y
方式一：使用安装包
方式二：使用Homebrew
# 安装Homebrew（如果没有）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装.NET SDK
brew install --cask dotnet-sdk
# 验证安装
dotnet --version
# 添加Microsoft包仓库
wget https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb
# 安装.NET SDK
sudo apt-get update
sudo apt-get install -y dotnet-sdk-8.0
# 验证安装
dotnet --version
# 添加Microsoft仓库
sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm
# 安装.NET SDK
sudo yum install -y dotnet-sdk-8.0
# 验证安装
dotnet --version
Visual Studio 2022是Windows平台上开发.NET项目的首选IDE。
安装步骤：
访问Visual Studio官网：https://visualstudio.microsoft.com/
下载Visual Studio 2022社区版（免费）
运行安装程序
在工作负载页面，选择以下组件：
在单个组件页面，确保选择：
点击安装，等待安装完成
推荐扩展：
安装完成后，建议安装以下扩展提升开发效率：
Rider是JetBrains推出的跨平台.NET IDE，在macOS和Linux上是很好的选择。
安装步骤：
Rider优势：
Admin.NET项目需要从NuGet获取依赖包。在国内环境下，建议配置镜像源以提高下载速度。
方式一：配置nuget.config文件
在用户目录下创建或修改nuget.config文件：
Windows位置：%APPDATA%\NuGet\NuGet.Config
macOS/Linux位置：~/.nuget/NuGet/NuGet.Config
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<packageSources>
<add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
<add key="huaweicloud" value="https://repo.huaweicloud.com/repository/nuget/v3/index.json" />
<add key="cnblogs" value="https://nuget.cnblogs.com/v3/index.json" />
</packageSources>
</configuration>
方式二：使用dotnet命令
# 添加华为云镜像
dotnet nuget add source https://repo.huaweicloud.com/repository/nuget/v3/index.json -n huaweicloud
# 查看已配置的源
dotnet nuget list source
方式一：官网下载
node --version
# v20.x.x
npm --version
# 10.x.x
方式二：使用nvm-windows（推荐）
nvm允许你管理多个Node.js版本：
# 下载nvm-windows
# https://github.com/coreybutler/nvm-windows/releases
# 安装完成后
nvm install 20
nvm use 20
# 验证
node --version
使用nvm（推荐）
# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# 重启终端后安装Node.js
nvm install 20
nvm use 20
nvm alias default 20
# 验证
node --version
npm --version
使用Homebrew（macOS）
brew install node@20
Admin.NET前端项目使用pnpm作为包管理器，相比npm有更快的安装速度和更小的磁盘占用。
安装方式：
# 使用npm安装（推荐）
npm install -g pnpm
# 使用Homebrew（macOS）
brew install pnpm
# 验证安装
pnpm --version
# 9.x.x
配置pnpm镜像：
# 配置淘宝镜像
pnpm config set registry https://registry.npmmirror.com
# 验证配置
pnpm config get registry
Visual Studio Code是前端开发的首选编辑器。
安装步骤：
推荐扩展：
安装以下扩展以获得最佳Vue3开发体验：
{
"recommendations": [
"Vue.volar", // Vue语言服务
"Vue.vscode-typescript-vue-plugin", // TypeScript Vue插件
"dbaeumer.vscode-eslint", // ESLint
"esbenp.prettier-vscode", // Prettier代码格式化
"antfu.iconify", // Iconify图标预览
"lokalise.i18n-ally", // 国际化支持
"bradlc.vscode-tailwindcss", // TailwindCSS智能提示
"formulahendry.auto-rename-tag", // 自动重命名标签
"usernamehw.errorlens" // 错误高亮显示
]
}
VS Code配置：
在VS Code设置中添加以下配置：
{
"editor.formatOnSave": true,
"editor.codeActionsOnSave": {
"source.fixAll.eslint": true
},
"[vue]": {
"editor.defaultFormatter": "Vue.volar"
},
"[typescript]": {
"editor.defaultFormatter": "esbenp.prettier-vscode"
},
"[javascript]": {
"editor.defaultFormatter": "esbenp.prettier-vscode"
},
"typescript.tsdk": "node_modules/typescript/lib"
}
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
# macOS
brew install git
# Ubuntu/Debian
sudo apt-get install git
# CentOS
sudo yum install git
# 配置
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
Admin.NET支持多种数据库，以下介绍常用数据库的安装配置。
方式一：MySQL Installer
方式二：使用Docker
# 拉取MySQL镜像
docker pull mysql:8.0
# 运行MySQL容器
docker run -d --name mysql8 -p 3306:3306 -e MYSQL_ROOT_PASSWORD=Admin.NET -e MYSQL_DATABASE=AdminNET mysql:8.0
# 安装MySQL Server
sudo apt-get update
sudo apt-get install mysql-server
# 启动MySQL服务
sudo systemctl start mysql
sudo systemctl enable mysql
# 安全配置
sudo mysql_secure_installation
# 创建数据库用户
sudo mysql -u root -p
-- 创建数据库
CREATE DATABASE AdminNET DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
-- 创建用户
CREATE USER 'admin'@'%' IDENTIFIED BY 'Admin.NET';
-- 授权
GRANT ALL PRIVILEGES ON AdminNET.* TO 'admin'@'%';
FLUSH PRIVILEGES;
编辑my.cnf（Linux）或my.ini（Windows）：
[mysqld]
# 字符集设置
character-set-server=utf8mb4
collation-server=utf8mb4_general_ci
# 连接数设置
max_connections=500
# 缓存设置
innodb_buffer_pool_size=1G
query_cache_size=128M
# 日志设置
slow_query_log=1
slow_query_log_file=/var/log/mysql/slow.log
long_query_time=2
[client]
default-character-set=utf8mb4
安装SSMS（管理工具）：
# 添加Microsoft仓库
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -
sudo add-apt-repository "$(wget -qO- https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/mssql-server-2022.list)"
# 安装SQL Server
sudo apt-get update
sudo apt-get install -y mssql-server
# 配置SQL Server
sudo /opt/mssql/bin/mssql-conf setup
# 选择版本：2 (Developer)
# 设置sa密码
# 启动服务
sudo systemctl start mssql-server
sudo systemctl enable mssql-server
# 拉取镜像
docker pull mcr.microsoft.com/mssql/server:2022-latest
# 运行容器
docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=Admin.NET123" \
-p 1433:1433 --name sqlserver2022 \
-d mcr.microsoft.com/mssql/server:2022-latest
# Ubuntu/Debian
sudo apt-get install postgresql postgresql-contrib
# 启动服务
sudo systemctl start postgresql
sudo systemctl enable postgresql
# 创建用户和数据库
sudo -u postgres psql
-- 创建用户
CREATE USER admin WITH PASSWORD 'Admin.NET';
-- 创建数据库
CREATE DATABASE "AdminNET" OWNER admin;
-- 授权
GRANT ALL PRIVILEGES ON DATABASE "AdminNET" TO admin;
Admin.NET支持使用Redis作为缓存服务器，推荐在生产环境中使用。
Windows没有官方Redis，可以使用以下方式：
方式一：使用Docker
docker run -d --name redis -p 6379:6379 redis:7
方式二：使用WSL2
# 在WSL2中
sudo apt-get install redis-server
sudo service redis-server start
# Ubuntu/Debian
sudo apt-get install redis-server
# 启动服务
sudo systemctl start redis
sudo systemctl enable redis
# 验证
redis-cli ping
# 返回PONG
编辑redis.conf：
# 绑定地址（生产环境建议绑定具体IP）
bind 0.0.0.0
# 端口
port 6379
# 密码
requirepass Admin.NET
# 最大内存
maxmemory 512mb
# 内存淘汰策略
maxmemory-policy allkeys-lru
# 持久化
appendonly yes
从Gitee克隆（推荐国内用户）：
# 克隆完整仓库
git clone https://gitee.com/zuohuaijun/Admin.NET.git
# 或者只克隆最新版本（更快）
git clone --depth 1 https://gitee.com/zuohuaijun/Admin.NET.git
# 进入项目目录
cd Admin.NET
从GitHub克隆：
git clone https://github.com/zuohuaijun/Admin.NET.git
从GitCode克隆：
git clone https://gitcode.com/zuohuaijun/Admin.NET.git
如果不熟悉Git，也可以直接下载源码包：
克隆完成后，项目目录结构如下：
Admin.NET/
├── Admin.NET/ # 后端解决方案
│ ├── Admin.NET.Application/ # 应用层（示例）
│ ├── Admin.NET.Core/ # 核心层（核心功能）
│ ├── Admin.NET.Test/ # 测试项目
│ ├── Admin.NET.Web.Core/ # Web核心配置
│ ├── Admin.NET.Web.Entry/ # Web启动入口
│ ├── Plugins/ # 插件目录
│ └── Admin.NET.sln # 解决方案文件
├── Web/ # 前端项目
│ ├── src/ # 源代码
│ ├── public/ # 静态资源
│ ├── package.json # 包配置
│ └── vite.config.ts # Vite配置
├── docker/ # Docker配置
├── doc/ # 文档和图片
└── README.md # 项目说明
打开配置文件Admin.NET/Admin.NET.Web.Entry/appsettings.json，修改数据库连接字符串：
MySQL配置：
{
"DbSettings": {
"EnableInitDb": true,
"EnableInitSeed": true,
"EnableDiffLog": false,
"EnableUnderLine": true,
"DbConfigs": [
{
"ConfigId": "1300000000001",
"DbType": "MySql",
"ConnectionString": "Data Source=localhost;Database=AdminNET;User ID=root;Password=Admin.NET;pooling=true;port=3306;sslmode=none;CharSet=utf8mb4;AllowLoadLocalInfile=true",
"IsAutoCloseConnection": true,
"EnableSqlLog": true
}
]
}
}
SQL Server配置：
{
"DbSettings": {
"EnableInitDb": true,
"EnableInitSeed": true,
"DbConfigs": [
{
"ConfigId": "1300000000001",
"DbType": "SqlServer",
"ConnectionString": "Data Source=localhost;Initial Catalog=AdminNET;User ID=sa;Password=Admin.NET123;TrustServerCertificate=true",
"IsAutoCloseConnection": true,
"EnableSqlLog": true
}
]
}
}
PostgreSQL配置：
{
"DbSettings": {
"EnableInitDb": true,
"EnableInitSeed": true,
"DbConfigs": [
{
"ConfigId": "1300000000001",
"DbType": "PostgreSQL",
"ConnectionString": "Host=localhost;Port=5432;Database=AdminNET;Username=admin;Password=Admin.NET",
"IsAutoCloseConnection": true,
"EnableSqlLog": true
}
]
}
}
如果使用Redis作为缓存，修改配置：
{
"Cache": {
"CacheType": "Redis",
"Redis": {
"ConnectionString": "localhost:6379,password=Admin.NET,defaultDatabase=0"
}
}
}
如果不使用Redis，保持默认的内存缓存：
{
"Cache": {
"CacheType": "Memory"
}
}
Admin.NET/Admin.NET.sln解决方案文件Admin.NET.Web.Entry设为启动项目（右键 -> 设为启动项目）首次运行说明：
首次运行时，系统会自动：
# 进入后端项目目录
cd Admin.NET/Admin.NET
# 还原NuGet包
dotnet restore
# 运行项目
cd Admin.NET.Web.Entry
dotnet run
# 或者指定环境
dotnet run --environment Development
运行成功后，可以访问：
打开浏览器访问Swagger文档页面，可以看到所有API接口列表。
测试登录接口：
/api/sysAuth/login接口{
"account": "superAdmin",
"password": "123456"
}
# 进入前端项目目录
cd Web
# 安装依赖（使用pnpm）
pnpm install
# 如果安装失败，尝试清除缓存后重试
pnpm store prune
pnpm install
常见依赖安装问题：
如果遇到网络问题，可以使用镜像：
# 设置镜像
pnpm config set registry https://registry.npmmirror.com
# 重新安装
pnpm install
打开Web/.env.development文件，确认后端接口地址：
# 开发环境配置
VITE_PORT = 2800
VITE_OPEN = true
VITE_API_URL = http://localhost:5005
# 启动开发服务器
pnpm run dev
# 或者
pnpm dev
启动成功后，控制台会显示：
VITE v5.x.x ready in xxx ms
➜ Local: http://localhost:2800/
➜ Network: http://192.168.x.x:2800/
superAdmin123456# 开发环境运行
pnpm dev
# 生产环境构建
pnpm build
# 预览生产构建
pnpm preview
# 代码格式检查
pnpm lint
# 代码格式修复
pnpm lint:fix
# 生成API接口代码
pnpm api:build
症状：提示找不到包或网络超时
解决方案：
# 清除NuGet缓存
dotnet nuget locals all --clear
# 添加镜像源
dotnet nuget add source https://repo.huaweicloud.com/repository/nuget/v3/index.json -n huaweicloud
# 重新还原
dotnet restore
症状：启动时提示无法连接数据库
解决方案：
症状：提示端口5005已被占用
解决方案：
修改launchSettings.json中的端口：
{
"profiles": {
"Admin.NET.Web.Entry": {
"applicationUrl": "http://localhost:5006"
}
}
}
或者结束占用端口的进程：
# Windows
netstat -ano | findstr :5005
taskkill /PID <进程ID> /F
# Linux/macOS
lsof -i :5005
kill -9 <进程ID>
症状：提示数据库不存在
解决方案：
appsettings.json中EnableInitDb设置为true症状：依赖安装报错或超时
解决方案：
# 清除缓存
pnpm store prune
rm -rf node_modules
rm pnpm-lock.yaml
# 使用镜像
pnpm config set registry https://registry.npmmirror.com
# 重新安装
pnpm install
症状：运行时提示Node版本过低
解决方案：
# 查看当前版本
node --version
# 使用nvm切换版本
nvm install 20
nvm use 20
症状：浏览器控制台显示CORS错误
解决方案：
.env.development中的API地址是否正确症状：登录成功但页面空白或报错
解决方案：
在开始开发前，确认以下环境已正确配置：
dotnet --version）node --version）pnpm --version）git --version）本章详细介绍了Admin.NET开发环境的搭建过程，包括：
完成本章的环境搭建后，你应该能够成功运行Admin.NET项目，并访问系统的登录页面。在下一章中，我们将深入了解Admin.NET的项目架构和核心模块。
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。