1. eShop本地运行环境准备
作为电商系统开发者的标配工具，eShop的本地化部署能极大提升开发调试效率。不同于直接操作线上环境，本地运行可以自由测试支付回调、订单状态修改等敏感操作，还能避免多人协作时的环境冲突问题。
我经手过三个不同技术栈的eShop项目，发现.NET Core版本在Windows环境下的兼容性最佳。以下是经过验证的环境配置清单：
- 硬件要求：4核CPU/8GB内存/50GB SSD（低于此配置运行调试工具时易卡顿）
- 必备组件：
- Visual Studio 2022 Community Edition（版本17.4+）
- .NET 6.0 SDK
- Docker Desktop（用于容器化数据库）
- SQL Server 2019 Developer Edition
- 可选工具：
- Postman（API调试）
- Redis Desktop Manager（缓存管理）
- Azure Storage Emulator（云存储模拟）
重要提示：安装Docker时务必启用WSL2后端，传统Hyper-V模式会导致端口映射异常。我在三个不同版本的Win10上测试发现，19045.3803以上版本的系统兼容性最佳。
2. 源码获取与工程结构解析
官方推荐通过Git克隆仓库获取最新代码：
git clone https://github.com/dotnet-architecture/eShopOnContainers.git工程采用微服务架构，主要包含以下关键目录：
├── src │ ├── Services │ │ ├── Basket（购物车服务） │ │ ├── Catalog（商品服务） │ │ └── Ordering（订单服务） │ └── Web │ └── WebMVC（前端入口） ├── docker-compose.yml（容器编排文件） └── env（环境变量配置）2.1 配置项修改要点
首次运行前需要调整三个核心配置：
docker-compose.yml中的端口映射（避免与本地已有服务冲突）WebMVC/appsettings.json的IdentityUrl（身份认证地址）env/nginx-conf/nginx.conf的服务器名称
我建议使用VSCode的Multi-root Workspace功能同时编辑这些文件，比逐个打开效率提升50%以上。
3. 容器化启动全流程
3.1 数据库服务初始化
docker-compose -f docker-compose.yml up -d mssql redis rabbitmq这条命令会启动：
- SQL Server容器（端口1433）
- Redis缓存容器（端口6379）
- RabbitMQ消息队列（端口5672）
踩坑记录：首次启动SQL容器时若报"SA密码不符合策略"，需进入容器执行：
docker exec -it eshop-mssql /opt/mssql-tools/bin/sqlcmd -S localhost -U SA -P "your_password" -Q "ALTER LOGIN SA WITH PASSWORD='YourNewStrong!Passw0rd'"
3.2 应用服务构建与启动
dotnet restore dotnet build docker-compose up -d构建过程约需8-15分钟（视硬件性能而定）。建议在VS中打开"输出"窗口监控构建进度，遇到NuGet包下载失败时右键解决方案选择"还原NuGet包"。
4. 常见问题排查指南
4.1 端口冲突解决方案
错误现象：Address already in use处理方法：
- 查询占用端口的进程：
netstat -ano | findstr :5104 - 在任务管理器结束对应PID进程，或修改
docker-compose.yml中的外部端口号
4.2 跨服务通信失败
典型报错：Connection refused检查步骤：
- 确认所有容器正常运行：
docker ps -a - 测试服务连通性：
docker exec -it eshop-basket curl http://catalog:5101
4.3 前端资源加载异常
解决方案：
- 清除浏览器缓存
- 检查nginx日志：
docker logs eshop-nginx - 重建前端容器：
docker-compose up -d --force-recreate webmvc
5. 性能优化实战技巧
经过20+次部署测试，总结出三个关键优化点：
镜像构建加速：
# 在Dockerfile中加入缓存指令 RUN dotnet restore --packages /packages COPY . . RUN dotnet build --no-restore开发模式热重载：
dotnet watch run --project src/Web/WebMVC数据库连接池配置：
"ConnectionStrings": { "CatalogDB": "Server=eshop-mssql;Database=CatalogDB;User=sa;Password=your_password;Max Pool Size=200;" }
最后分享一个监控技巧：在VS的"诊断工具"窗口中开启CPU和内存分析，能快速定位到具体服务的性能瓶颈。我在实际项目中通过这个方法发现过Redis连接泄漏问题，将响应时间从1200ms降到200ms以内。
