内网开发救星：手把手教你用nuget.exe下载并离线安装C#依赖包（附完整命令）
在企业级开发环境中，网络隔离是常见的安全策略，但这也给依赖管理带来了巨大挑战。上周我接手一个金融系统升级项目，客户服务器完全禁止外网访问，而项目依赖的37个NuGet包及其嵌套依赖让团队一度陷入困境。经过三天实战摸索，终于总结出这套完整的离线解决方案，现在分享给同样受困于内网环境的开发者们。
1. 环境准备与工具配置
1.1 获取nuget.exe命令行工具
最新稳定版的nuget.exe可通过微软官方渠道获取：
# 使用PowerShell下载（需管理员权限） Invoke-WebRequest -Uri https://dist.nuget.org/win-x86-commandline/latest/nuget.exe -OutFile $env:SYSTEMROOT\nuget.exe建议将nuget.exe放入系统PATH路径（如C:\Windows），这样可以在任意目录调用。验证安装成功的命令：
nuget help | findstr "NuGet Version"1.2 创建本地包仓库目录结构
合理的目录结构能避免后续迁移混乱，推荐按以下方式组织：
OfflineNugetRepo/ ├── Packages/ # 主存储目录 ├── Temp/ # 临时下载缓存 └── Config/ # 自定义nuget配置在Config目录下创建nuget.config文件，内容如下：
<?xml version="1.0" encoding="utf-8"?> <configuration> <config> <add key="repositoryPath" value="..\Packages" /> </config> </configuration>2. 完整依赖链下载实战
2.1 单包下载与依赖解析
以下命令会下载EntityFramework 6.4.4及其所有依赖项：
nuget install EntityFramework -Version 6.4.4 -OutputDirectory .\Packages -Source https://api.nuget.org/v3/index.json -PackageSaveMode nupkg -DependencyVersion Highest -Verbosity detailed关键参数解析：
| 参数 | 作用 | 推荐值 |
|---|---|---|
-OutputDirectory | 指定包存储路径 | 绝对路径更可靠 |
-DependencyVersion | 依赖版本策略 | Highest（最高兼容） |
-PackageSaveMode | 保存格式 | nupkg（保留原始包） |
-Verbosity | 日志级别 | detailed（调试时使用） |
2.2 批量下载解决方案所有依赖
对于已有.sln文件的项目，使用以下命令可一次性下载全部依赖：
nuget restore YourSolution.sln -PackagesDirectory .\Packages -ConfigFile .\Config\nuget.config注意：此命令需要在解决方案所在目录执行，否则需指定
-SolutionDirectory参数
3. 离线环境迁移与安装
3.1 包仓库的完整迁移
将整个Packages目录压缩后传输到内网环境，建议：
- 使用Robocopy保证文件完整性：
robocopy .\Packages Z:\OfflineRepo /MIR /Z /R:3 /W:5 /LOG:copy.log - 校验文件哈希值：
Get-FileHash .\Packages\* -Algorithm SHA256 | Export-Csv hashes.csv
3.2 Visual Studio中的离线源配置
在内网机器的VS中按以下步骤操作：
- 打开工具 > NuGet包管理器 > 程序包管理器设置
- 添加新的包源：
- 名称：
LocalOfflineRepo - 源路径：
Z:\OfflineRepo（指向迁移的Packages目录）
- 名称：
- 将其设为默认源
3.3 离线安装的两种方式
方式一：包管理器控制台
Install-Package Newtonsoft.Json -Version 13.0.1 -Source Z:\OfflineRepo方式二：修改项目文件直接引用
在.csproj文件中添加：
<ItemGroup> <PackageReference Include="Newtonsoft.Json" Version="13.0.1" /> </ItemGroup>4. 高级技巧与故障排查
4.1 依赖冲突解决方案
当多个包要求不同版本的同一依赖时，尝试：
- 使用bindingRedirect（适用于.NET Framework）：
<dependentAssembly> <assemblyIdentity name="System.ValueTuple" /> <bindingRedirect oldVersion="0.0.0.0-4.0.3.0" newVersion="4.0.3.0" /> </dependentAssembly> - 通过
-ExcludeVersion参数重新组织包目录
4.2 版本锁定与重复包处理
创建packages.lock.json文件确保一致性：
dotnet restore --locked-mode对于重复包问题，可使用以下PowerShell脚本清理：
Get-ChildItem -Recurse -Filter *.nupkg | Group-Object Name | Where-Object { $_.Count -gt 1 } | ForEach-Object { $_.Group | Select-Object -Skip 1 | Remove-Item -Force }4.3 搭建本地NuGet服务器（可选）
对于长期内网开发，建议使用BaGet搭建私有服务器：
# 使用Docker快速部署 docker run -d -p 5555:80 --name nuget-server loicsharma/baget上传已有包到服务器：
nuget push .\Packages\*.nupkg -Source http://localhost:5555/v3/index.json -ApiKey NUGET-SERVER-KEY
