.NET中怎么把程序集放入 GAC 中

封面图 • 2025-09-23 • .NET

在 .NET 中，将程序集（Assembly）放入 **全局程序集缓存（Global Assembly Cache, GAC）** 是一种将程序集共享给多个应用程序使用的方式。GAC 通常用于存储那些被多个应用程序引用的强名称程序集。

### 一、准备工作

要将一个程序集放入 GAC，必须满足以下条件：

1. **程序集必须是强命名的（Strong-Named）**  
   - 即：使用 `sn.exe` 工具生成的公钥/私钥对进行签名。
   - 如果你没有强命名程序集，可以使用 `sn -k keyfile.snk` 生成一个密钥文件，然后用 `csc /keyfile:keyfile.snk` 编译程序集。

2. **程序集必须有正确的版本号和信息**  
   - GAC 使用程序集的 **名称 + 版本 + 公钥令牌** 来唯一标识一个程序集。

---

### 二、将程序集放入 GAC 的方法

#### 方法 1：使用 `gacutil.exe`（推荐）

这是最常用的方法，适用于开发和测试环境。

##### 步骤：

1. 打开命令提示符（以管理员身份运行）。
2. 使用 `gacutil -i <assembly.dll>` 命令安装程序集到 GAC。

```cmd
gacutil -i MyAssembly.dll
```

##### 可选参数：

- `-f`：强制覆盖已存在的程序集。
- `-nologo`：不显示版权信息。

示例：

```cmd
gacutil -i -f MyAssembly.dll
```

##### 验证是否成功：

```cmd
gacutil -l MyAssembly
```

#### 方法 2：使用 PowerShell（适用于 Windows）

你可以使用 PowerShell 脚本来将程序集添加到 GAC。

```powershell
Add-Type -AssemblyName System.EnterpriseServices
$publish = New-Object System.EnterpriseServices.Internal.Publish
$publish.GacInstall("C:\Path\To\MyAssembly.dll")
```

> 注意：这种方法需要管理员权限。

#### 方法 3：手动复制到 GAC 目录（不推荐）

GAC 的路径通常是：

- **Windows 7/8/10/11**：
  - 32 位程序集：`C:\Windows\Assembly`
  - 64 位程序集：`C:\Windows\Microsoft.NET\Assembly`

但手动复制并不推荐，因为 GAC 会自动处理程序集的注册和版本管理。

---

### 三、从 GAC 中移除程序集

使用 `gacutil -u <assembly-name>`：

```cmd
gacutil -u MyAssembly
```

或者：

```cmd
gacutil -u MyAssembly, Version=1.0.0.0, Culture=neutral, PublicKeyToken=... 
```

---

### 四、注意事项

- **GAC 仅支持强命名程序集**。
- **GAC 通常用于部署共享组件**，比如第三方库或企业内部组件。
- 在 .NET Core 或 .NET 5+ 中，**GAC 不再被支持**，而是通过 NuGet 包管理来管理依赖项。

---

### 五、总结

| 方法 | 说明 | 推荐程度 |
|------|------|----------|
| `gacutil -i` | 最常用，简单直接 | ⭐⭐⭐⭐⭐ |
| PowerShell | 适合脚本化操作 | ⭐⭐⭐⭐ |
| 手动复制 | 不推荐，容易出错 | ⭐ |

---

如果你是在开发环境中测试，建议使用 `gacutil`；如果是生产环境，考虑使用 NuGet 或者配置好依赖项。

如需帮助生成强命名程序集，我也可以提供详细步骤。