Chocolatey 包管理器完整学习笔记 - 学习笔记-Claude Code-上海佼艾

一、Chocolatey 概述

1.1 什么是 Chocolatey

Chocolatey 是 Windows 平台上的第三方包管理器，类似于 Linux 上的 apt-get 或 yum。它基于 NuGet 包基础设施构建，使用 PowerShell 作为脚本引擎，允许用户通过命令行自动完成软件的安装、升级、卸载和配置管理。Chocolatey 的核心理念是将 Linux 包管理的便利性带到 Windows 世界。

Chocolatey 的核心理念："Chocolatey NuGet is a Machine Package Manager, somewhat like apt-get, but for Windows." 它封装了软件的安装过程，使得一条命令就能完成下载、验证、安装、配置的全部流程，极大简化 Windows 软件管理。

Chocolatey 最初由 Rob Reynolds 于 2011 年创建，旨在填补 Windows 平台缺乏统一包管理工具的空白。经过十余年的发展，它已经成为 Windows 生态中最成熟、最广泛使用的第三方包管理器，拥有超过 9500 个社区维护的软件包和数十万用户。

1.2 发展历史

2011 年：Rob Reynolds 发布 Chocolatey 初始版本，基于 NuGet 基础设施，最初只是一个简单的 PowerShell 脚本工具
2013 年：加入 Chocolatey GUI 工具，提供图形化界面管理已安装包
2015 年：引入 Chocolatey Licensed Edition（商业版），提供企业级功能如 Package Internalizer（离线打包）
2017 年：重构核心架构，引入 Chocolatey Central Management（中央管理控制台）
2019 年：社区仓库（community.chocolatey.org）包数量突破 7000 个，下载量超过 3 亿次
2021 年：发布 Chocolatey CLI 2.0 版本，性能大幅提升，包结构更加规范
2023 年至今：持续迭代优化，与 GitHub Actions、Azure DevOps 等 CI/CD 工具深度集成

1.3 与 Windows 包管理生态对比

Windows 平台上目前主要有三大包管理工具，各自有不同的定位和适用场景：

特性	Chocolatey	winget	Scoop
开发商	社区 + Chocolatey Software	Microsoft（官方）	社区开源
首次发布	2011 年	2020 年	2016 年
底层技术	NuGet + PowerShell	MSIX / COM / App Installer	便携式应用 + 7-Zip
安装方式	系统级安装（可能需要管理员权限）	系统级安装（内置于 Windows 10/11）	用户级安装（不修改注册表/系统路径）
包数量	~9500+（社区）	~6000+（社区）	~5000+（主仓库）
企业功能	丰富（离线/审计/GPO）	基础	无
GUI 支持	有（Chocolatey GUI）	无（仅命令行）	无（仅命令行）
依赖管理	强大（自动处理依赖）	基础	基础
适合场景	企业环境、自动化部署、系统管理员	普通用户快速安装	开发者便携工具管理

工具选型建议

Chocolatey：最适合系统管理员和企业 IT 环境，提供完整的软件生命周期管理、离线安装支持和审计功能。
winget：适合 Windows 10/11 普通用户快速安装常见应用程序，无需额外安装包管理器。
Scoop：适合开发者管理命令行工具和便携应用，不需要管理员权限即可安装。

1.4 Chocolatey 的独特优势

成熟的生态系统：拥有超过十年的发展历史，社区庞大且活跃，包的质量和覆盖面都有保障
企业级特性：商业版提供离线安装包创建（Package Internalizer）、配置管理、中央管理控制台等企业级功能
自动化脚本支持：完美集成 PowerShell Desired State Configuration (DSC) 和配置管理工具
软件生命周期管理：支持安装、锁定版本、升级、卸载、回滚的完整流程
CI/CD 集成：可与 Jenkins、Azure DevOps、GitHub Actions 等持续集成工具无缝对接
自定义包源：支持搭建私有 NuGet 仓库，适合企业内部软件分发

二、安装与环境配置

2.1 系统要求

在安装 Chocolatey 之前，需要确保系统满足以下基本要求：

操作系统：Windows 7+ / Windows Server 2003+（推荐 Windows 10/11 或 Windows Server 2016+）
PowerShell 版本：PowerShell 2.0+（强烈推荐 PowerShell 5.0+）
.NET Framework：4.0+（推荐 4.5+）
执行策略：PowerShell 执行策略需要允许执行脚本（至少 RemoteSigned）
网络访问：需要能够访问 chocolatey.org 和 packages.chocolatey.org

2.2 PowerShell 安装方式

Chocolatey 官方推荐通过 PowerShell 进行安装。使用以下命令在管理员 PowerShell 中执行：

# 方法一：官方推荐安装（最简单）

Set-ExecutionPolicy Bypass -Scope Process -Force;

[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072;

iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

# 方法二：使用官方安装脚本（更安全）

$installScript = Invoke-WebRequest -Uri 'https://community.chocolatey.org/install.ps1' -UseBasicParsing

Invoke-Expression $installScript

安装注意事项

1. 必须以管理员身份运行 PowerShell，否则安装会失败。
2. 安装过程中会检查并自动安装 Chocolatey 的依赖组件（如 .NET Framework 4.0+、NuGet 等）。
3. 安装完成后，需重新打开 PowerShell 或 CMD 窗口才能使用 choco 命令。
4. 首次运行时，Chocolatey 会自动下载并安装其内置的 NuGet 包提供程序。

2.3 安装后验证

安装完成后，使用以下命令验证 Chocolatey 是否正常工作：

# 查看 Chocolatey 版本

choco --version

# 查看详细安装信息

choco info

# 查看帮助

choco -?

2.4 安装目录结构

Chocolatey 的默认安装目录为 C:\ProgramData\chocolatey，其目录结构如下：

bin\：存放 Chocolatey CLI 可执行文件和工具快捷方式（choco.exe、chocolatey.cmd 等）
lib\：存放已安装的软件包数据（每个包一个子目录，包含 .nupkg 文件和工具脚本）
lib-bad\：存放安装失败的软件包记录
config\：存放 Chocolatey 配置文件（chocolatey.config）
logs\：存放 Chocolatey 操作日志文件
helpers\：存放 Chocolatey 的 PowerShell 辅助函数模块
tools\：存放 Chocolatey 核心工具脚本
redirects\：存放 shim 重定向文件，用于管理命令别名

2.5 配置 Chocolatey 特性

Chocolatey 提供丰富的特性配置，可以通过 choco feature 命令管理：

# 查看所有可用特性及当前状态

choco feature list

# 启用/禁用某个特性

choco feature enable --name="allowGlobalConfirmation"

choco feature disable --name="showDownloadProgress"

# 常用特性说明：

# allowGlobalConfirmation — 安装时跳过确认提示（自动化环境建议启用）

# checksumFiles — 安装时校验文件哈希（建议保持启用）

# autoUninstaller — 使用自动卸载器（安装时自动创建卸载信息）

# failOnAutoUninstaller — 自动卸载失败时终止操作

# showDownloadProgress — 显示下载进度（禁用可在 CI 环境中减少日志输出）

2.6 代理配置

在企业网络环境中，通常需要通过代理服务器访问互联网。Chocolatey 支持多种代理配置方式：

# 方法一：通过 choco 命令选项

choco install vscode --proxy="http://proxy.company.com:8080"

# 方法二：设置环境变量（推荐持久化方式）

[Environment]::SetEnvironmentVariable("chocolateyProxyLocation", "http://proxy.company.com:8080", "Machine")

[Environment]::SetEnvironmentVariable("chocolateyProxyUser", "domain\username", "Machine")

[Environment]::SetEnvironmentVariable("chocolateyProxyPassword", "password", "Machine")

# 方法三：修改 Chocolatey 配置文件

# 编辑 C:\ProgramData\chocolatey\config\chocolatey.config

# 在 <config> 节点下添加代理配置

环境变量配置的优势：通过设置系统级环境变量来配置代理，可以在所有 choco 命令中自动生效，无需每次手动指定 --proxy 参数。注意代理密码在环境变量中以明文存储，生产环境建议使用安全的凭据管理方案。

2.7 变更安装目录

如果需要将 Chocolatey 安装到非默认目录，可以在安装前设置环境变量：

# 安装前设置自定义安装目录

$env:ChocolateyInstall = "D:\Tools\chocolatey"

# 然后执行安装脚本

iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

修改安装目录的注意事项

如果已经安装 Chocolatey 后再想修改安装目录，过程较为复杂：需要卸载 Chocolatey，设置环境变量后重新安装，或者使用 choco upgrade chocolatey --install-arguments="'/InstallDir:D:\Tools\chocolatey'"。建议在初始安装前就确定好安装目录。

三、核心命令详解

Chocolatey 的命令体系围绕软件包生命周期设计，涵盖搜索、安装、升级、卸载等完整流程。以下对每个核心命令进行详细说明。

3.1 choco install — 安装软件包

这是最常用的命令，用于从配置的源下载并安装软件包。Chocolatey 会自动处理依赖关系，确保所有必需的组件一同安装。

# 基本用法：安装单个包

choco install vscode

# 安装多个包（空格分隔）

choco install vscode googlechrome firefox 7zip

# 静默安装（无需确认，适合自动化脚本）

choco install vscode -y

# 从特定源安装

choco install vscode --source="https://myinternal.server/nuget"

# 安装特定版本

choco install nodejs --version=18.17.0

# 安装时指定其他安装参数

choco install python --installargs="ALLUSERS=1"

# 强制重新安装（即使已安装）

choco install vscode --force

工作原理：执行 choco install 时，Chocolatey 首先查询配置的软件源，下载对应的 .nuspec 包描述文件和 .nupkg 包文件，解析依赖关系，然后依次安装所有依赖包。每个包的安装过程会执行其 chocolateyInstall.ps1 脚本，自动完成下载、校验、解压、安装的完整流程。

3.2 choco uninstall — 卸载软件包

# 基本用法

choco uninstall vscode

# 静默卸载

choco uninstall vscode -y

# 卸载多个包

choco uninstall vscode firefox 7zip -y

# 强制卸载（删除所有相关文件）

choco uninstall vscode --force -y

# 删除包的所有依赖项

choco uninstall vscode --remove-dependencies -y

卸载机制

Chocolatey 的卸载流程依赖于软件的卸载脚本或系统的卸载程序。大多数官方包的 chocolateyUninstall.ps1 脚本会调用软件自带的卸载程序（如 uninstall.exe），或者通过 Windows Installer (msiexec) 执行卸载。--remove-dependencies 参数会同时卸载该软件包的依赖项，但需谨慎使用，因为依赖可能被其他包共享。

3.3 choco upgrade — 升级软件包

# 升级指定包

choco upgrade vscode

# 升级所有已安装的包

choco upgrade all

# 静默升级所有包

choco upgrade all -y

# 升级到指定版本

choco upgrade nodejs --version=20.11.0

# 升级时排除某些包

choco upgrade all --except="vscode,googlechrome"

升级最佳实践

choco upgrade all 会检查所有已安装 Chocolatey 包的最新版本并逐一升级。在企业环境中，建议在测试环境中先执行升级验证，再推送到生产环境。也可使用 --except 参数临时排除需要保持版本的包。

3.4 choco list / search — 搜索软件包

# 列出所有已安装的包

choco list --local-only

# 搜索远程源中的包

choco search git

# 精确搜索

choco search git --exact

# 按标签搜索

choco search --tag="python"

# 列出过期的包（可升级的）

choco outdated

# 带详细信息的列表

choco list --local-only --detail

# 限制返回数量

choco search python --limit=5

3.5 choco info — 查看包详细信息

# 查看包详情

choco info vscode

# 输出包含：名称、版本、描述、标签、依赖、校验和等

choco info 显示的信息包括：包名称、版本号、作者、发布者、描述信息、软件链接、包标签（tags）、依赖关系（Dependencies）、软件截图链接和校验和（Checksum）等。这些信息对评估包的可信度和了解其功能至关重要。

3.6 choco outdated — 查看可升级的包

# 查看所有可升级的包

choco outdated

# 忽略固定版本（pinned）的包

choco outdated --ignore-pinned

该命令会对比本地已安装版本和远程源中的最新版本，列出所有有更新的包。可结合自动化脚本实现定期检查并发送升级通知。

3.7 choco pin — 固定包版本

# 固定某个包，阻止其被升级

choco pin add --name="nodejs"

# 查看当前固定的所有包

choco pin list

# 移除固定限制

choco pin remove --name="nodejs"

固定的包在执行 choco upgrade all 时会被跳过，用于确保某些关键软件保持特定版本（如兼容性要求）。

3.8 choco feature — 管理特性开关

# 列出所有特性

choco feature list

# 启用特性

choco feature enable --name="allowGlobalConfirmation"

# 禁用特性

choco feature disable --name="showDownloadProgress"

# 查看特定特性状态

choco feature list --name="checksumFiles"

3.9 choco config — 配置管理

# 查看所有配置项

choco config list

# 设置配置值

choco config set --name="cacheLocation" --value="D:\choco_cache"

# 删除配置项

choco config unset --name="cacheLocation"

# 常用配置项：

# cacheLocation — 下载缓存目录位置

# commandExecutionTimeoutSeconds — 命令执行超时时间（默认2700秒）

# proxy — 代理服务器设置

# containsLegacyPackageInstalls — 是否包含旧版包安装

配置层级：Chocolatey 的配置优先级从高到低依次为：命令行参数 > 环境变量 > 配置文件（chocolatey.config）。这意味着通过命令行指定的参数会临时覆盖配置文件和环境变量中的设置，非常适合在脚本中临时变更配置。

3.10 choco source — 管理包源

# 列出所有已配置的包源

choco source list

# 添加新源

choco source add --name="internal" --source="https://my-server/nuget"

# 添加需要认证的私有源

choco source add --name="private-feed" --source="https://private-feed/nuget" --user="username" --password="password"

# 禁用某个源（临时）

choco source disable --name="chocolatey"

# 启用某个源

choco source enable --name="internal"

# 移除源

choco source remove --name="internal"

包源（Source）是 Chocolatey 获取软件包信息的来源。默认配置了 community.chocolatey.org 社区源，企业可以添加内部私有源来分发内部软件包。

四、包管理进阶

4.1 安装特定版本

Chocolatey 支持安装任意历史版本，这在需要保持特定版本兼容性时非常有用：

# 安装指定版本

choco install nodejs --version=16.20.0

# 安装预发布版本

choco install vscode --pre

# 查看包的所有可用版本

choco list nodejs --all-versions

# 降级到旧版本

choco upgrade nodejs --version=18.18.0 --allow-downgrade

版本管理策略

在生产环境中，建议使用版本锁定策略：先使用 choco pin add --name="包名" 固定关键软件的版本，然后通过自动化流程在测试环境中验证新版本后，再解除固定并进行升级。这样可以确保生产环境的稳定性。

4.2 并行安装

Chocolatey 允许同时安装多个软件包，极大提高部署效率：

# 方式一：一行命令安装多个包（串行执行）

choco install vscode googlechrome firefox 7zip nodejs python git -y

# 方式二：使用 PowerShell 并行安装（需要 PowerShell 7+）

$packages = @("vscode", "googlechrome", "firefox", "7zip", "nodejs", "python", "git")

$packages | ForEach-Object -Parallel {

    choco install $_ -y

} -ThrottleLimit 4

# 方式三：从配置文件批量安装

choco install packages.config

并行安装虽然可以节省时间，但同时下载多个大型安装包可能会使网络带宽饱和。建议根据网络环境合理设置并行度。

4.3 忽略依赖

# 安装时忽略所有依赖

choco install mypackage --ignore-dependencies

# 仅安装主包，不安装依赖（部分包支持）

choco install mypackage --skip-automation-scripts

使用时机

--ignore-dependencies 仅在你确定依赖已手动安装好，或者需要排除有问题的依赖包时使用。在正常情况下不要忽略依赖，否则可能导致安装的软件无法正常运行。例如，安装某些 Python 包时，如果忽略对 Python 运行时的依赖依赖，安装可能会成功但软件无法启动。

4.4 参数传递（--params / --installargs）

Chocolatey 支持向安装包传递自定义参数，实现定制化安装：

# --installargs: 传递给原生安装程序的参数

choco install python --installargs="ALLUSERS=1 INSTALLDIR=D:\Python3"

# --params: 传递给 Chocolatey 包脚本的自定义参数

choco install vscode --params="/NoDesktopIcon /NoQuicklaunchIcon"

# 组合使用

choco install sqlserver-express --params="'/InstanceName:SQLEXPRESS /SAPwd:MyStr0ngPwd'" --installargs=""/quiet""

# 查看包支持哪些参数

choco info mypackage

# 查看包的安装选项文档

choco install mypackage --help

区分 --installargs 和 --params：--installargs 直接传递给软件自带的安装程序（如 .exe 或 .msi 安装器的参数），而 --params 传递给 Chocolatey 包的 chocolateyInstall.ps1 脚本，由脚本决定如何使用。在使用前，应查阅包的文档了解支持的参数选项。

4.5 安装包配置文件（packages.config）

对于需要批量安装大量包的场景，Chocolatey 支持使用 XML 配置文件来定义安装列表：

# packages.config 文件示例

<?xml version="1.0" encoding="utf-8"?>

<packages>

  <package id="vscode" />

  <package id="googlechrome" />

  <package id="firefox" version="119.0.1" source="internal">

    <packageParameters>/NoDesktopIcon</packageParameters>

  </package>

  <package id="nodejs" version="18.18.0" />

  <package id="7zip.install" />

</packages>

choco install packages.config -y

使用 packages.config 可以建立标准化的软件安装清单，方便版本控制和团队共享。

4.6 使用 --force 重新安装和 --noop 预览

# 强制重新安装（即使已经安装了最新版本）

choco install vscode -y --force

# 使用 --noop 预览操作但不实际执行（预演模式）

choco upgrade all --noop

# 使用 --what-if 查看变更

choco install git --what-if

预览模式是生产环境中非常实用的功能，可以提前了解命令将要执行的操作，避免意外变更。

五、包创建与发布

5.1 包结构基础

一个 Chocolatey 软件包本质上是一个标准的 NuGet 包（.nupkg），包含描述包元数据的 .nuspec 文件和执行安装/卸载逻辑的 PowerShell 脚本。典型的包目录结构如下：

# 标准 Chocolatey 包目录结构

MyPackage/

├── MyPackage.nuspec        # 包元数据描述文件

├── tools/

│   ├── chocolateyInstall.ps1    # 安装脚本（必需）

│   ├── chocolateyBeforeModify.ps1 # 修改前脚本（可选）

│   ├── chocolateyUninstall.ps1   # 卸载脚本（可选）

│   ├── LICENSE.txt               # 许可证文件（可选）

│   ├── VERIFICATION.txt          # 验证说明（可选）

│   └── 其他辅助文件              # 脚本所需的其他资源

└── _metadata/

    └── ...                      # Chocolatey 生成的元数据

5.2 .nuspec 文件详解

.nuspec 文件是 XML 格式的包描述文件，定义了包的所有元数据信息：

<?xml version="1.0" encoding="utf-8"?>

<package xmlns="http://schemas.microsoft.com/packaging/2015/06/nuspec.xsd">

  <metadata>

    <id>mycompany.myapp</id>

    <title>MyCompany MyApp (Install)</title>

    <version>1.2.3</version>

    <authors>MyCompany</authors>

    <projectUrl>https://mycompany.com/myapp</projectUrl>

    <iconUrl>https://mycompany.com/icon.png</iconUrl>

    <licenseUrl>https://mycompany.com/license</licenseUrl>

    <requireLicenseAcceptance>true</requireLicenseAcceptance>

    <projectSourceUrl>https://github.com/mycompany/myapp</projectSourceUrl>

    <docsUrl>https://mycompany.com/docs</docsUrl>

    <mailingListUrl>https://mycompany.com/support</mailingListUrl>

    <bugTrackerUrl>https://mycompany.com/bugs</bugTrackerUrl>

    <packageSourceUrl>https://github.com/mycompany/choco-packages</packageSourceUrl>

    <tags>myapp mycompany admin tool</tags>

    <summary>MyCompany MyApp - 企业级应用管理工具</summary>

    <description>MyCompany MyApp 是一款用于管理企业资源的综合工具。</description>

    <releaseNotes>修复了已知问题并提升了性能</releaseNotes>

    <dependencies>

      <dependency id="dotnetfx" version="4.8.0" />

      <dependency id="vcredist2015" />

    </dependencies>

  </metadata>

</package>

5.3 chocolateyInstall.ps1 脚本详解

这是 Chocolatey 包的核心安装脚本，定义了包的安装逻辑。使用 Chocolatey 提供的辅助函数（Helpers）可以轻松实现标准安装流程：

# 标准安装脚本示例

$packageName = 'mycompany.myapp'

$toolsDir   = "$(Split-Path -parent $MyInvocation.MyCommand.Definition)"

$url        = 'https://mycompany.com/downloads/myapp-1.2.3-x64.msi'

$url64      = 'https://mycompany.com/downloads/myapp-1.2.3-x64.msi'

$checksum   = 'ABC123DEF456...'

$checksum64 = 'ABC123DEF456...'

$packageArgs = @{

    packageName   = $packageName

    fileType      = 'msi'

    url           = $url

    url64bit      = $url64

    checksum      = $checksum

    checksum64    = $checksum64

    checksumType  = 'sha256'

    silentArgs    = "/quiet /norestart"

    validExitCodes= @(0, 3010)

}

Install-ChocolateyPackage @packageArgs

Chocolatey 提供了丰富的 PowerShell 辅助函数：

Install-ChocolateyPackage：通用的软件安装函数，支持 .exe、.msi、.msu 等格式
Install-ChocolateyZipPackage：安装 ZIP 压缩包格式的应用
Install-ChocolateyInstallPackage：更底层的手动安装函数
Get-ChocolateyWebFile：下载文件到指定目录
Install-ChocolateyEnvironmentVariable：设置系统或用户环境变量
Set-PowerShellExitCode：设置 PowerShell 退出码
Start-ChocolateyProcessAsAdmin：以管理员权限运行进程

5.4 打包与发布

# 创建 .nupkg 包文件

choco pack

# 推送包到社区源（需要 API Key）

choco push mypackage.1.2.3.nupkg --source="https://push.chocolatey.org/"

# 推送到私有源

choco push mypackage.1.2.3.nupkg --source="https://my-server/nuget"

# 从本地 .nupkg 文件安装（用于测试）

choco install mypackage.1.2.3.nupkg -y

5.5 内部源搭建

企业通常需要搭建内部的 Chocolatey 包源来分发自定义软件包。以下是几种常见的搭建方案：

# 方案一：使用 NuGet.Server（最简单）

# 1. 创建一个空的 ASP.NET Web 应用

# 2. 通过 NuGet 安装 NuGet.Server 包

# Install-Package NuGet.Server

# 3. 将 .nupkg 文件放入 Packages 文件夹

# 方案二：使用 BaGet（轻量级开源 NuGet 服务）

# docker run -d --name baget -p 5555:80 -v ${PWD}/baget-data:/var/baget liudeba/baget

# 方案三：使用 Nexus Repository OSS

# 支持多种包格式，包括 NuGet/Chocolatey

# 方案四：使用 ProGet（Inedo 的商业 NuGet 服务器）

# 与 Chocolatey 深度集成，提供企业级功能

# 方案五：使用 Azure Artifacts（云方案）

# 与 Azure DevOps 深度集成，适合使用微软生态的企业

离线环境部署的关键：在完全离线的环境中，使用 Chocolatey 商业版的 Package Internalizer 功能可以将社区包及其所有依赖和资源"内部化"——即预先下载所有安装文件和依赖项，重新打包为内部包，从而在无互联网访问的环境中正常安装。

5.6 自动化打包流程

结合 CI/CD 工具可以实现包的自动构建和发布：

# GitHub Actions 工作流示例

# .github/workflows/choco-pack.yml

name: Chocolatey Package Build and Publish

on:

  push:

    branches: [ main ]

    paths:

      - 'packages/**'

jobs:

  build:

    runs-on: windows-latest

    steps:

      - uses: actions/checkout@v4

      - name: Build Chocolatey Package

        shell: powershell

        run: choco pack .\packages\mypackage\

      - name: Push to Internal Feed

        shell: powershell

        run: |

          choco push *.nupkg --source "https://my-server/nuget" --api-key "${{ secrets.NUGET_API_KEY }}"

六、企业级使用

6.1 离线安装方案

企业内网环境通常无法直接访问互联网，Chocolatey 商业版的 Package Internalizer 功能专门解决这一问题：

# Package Internalizer 将在线包转为离线包

choco download vscode --internalize --output-directory=D:\offline-packages

# 离线安装已下载的包

choco install vscode --source=D:\offline-packages

# 批量下载多个包的离线版本

choco download packages.config --internalize --output-directory=D:\offline-packages

Package Internalizer 的工作原理是：解析指定包的 chocolateyInstall.ps1 脚本，检测其中引用的所有外部下载链接，预先下载这些文件并将其嵌入到重新打包的 .nupkg 中。这样，离线环境安装时就不需要访问外部网络了。

6.2 GPO 集成

Chocolatey 可以与 Windows Group Policy Object (GPO) 集成，实现大规模的软件部署和配置管理：

启动/登录脚本：通过 GPO 配置计算机启动脚本或用户登录脚本，自动执行 choco install/upgrade 命令
计划任务集成：通过 GPO 部署计划任务，定期执行 choco upgrade all 确保软件保持最新
软件限制策略：使用 choco audit 命令生成的审计结果，配合 GPO 限制未经批准的软件
配置基线管理：通过 GPO 结合 Chocolatey 确保所有计算机安装的软件符合安全基线

6.3 配置管理工具集成

Chocolatey 与主流配置管理工具深度集成：

工具	集成方式	使用场景
Ansible	win_chocolatey 模块	跨平台自动化运维，管理 Windows 节点软件
Puppet	chocolatey/chocolatey 模块	企业级配置管理，保证软件状态一致性
Chef	chocolatey_package 资源	基础设施即代码，Windows 服务器配置
PowerShell DSC	cChoco 模块	Windows 原生配置管理，集中管理软件状态
Terraform	provisioner 中调用 choco	基础设施创建时自动安装软件

# Ansible win_chocolatey 示例

- name: 确保 VS Code 已安装

  win_chocolatey:

    name: vscode

    state: present

    version: '1.85.0'

# PowerShell DSC 示例

Configuration SoftwareConfig {

    Import-DscResource -ModuleName cChoco

    cChocoPackageInstaller VSCode {

        Name   = "vscode"

        Ensure = "Present"

        Version = "1.85.0"

    }

}

6.4 审计与日志

Chocolatey 提供完善的日志记录功能，便于企业进行审计和安全追踪：

操作日志：所有 choco 命令操作都会记录到 C:\ProgramData\chocolatey\logs\chocolatey.log
详细日志级别：使用 choco install package --verbose 获取详细的调试信息
安装历史：通过 choco list --local-only 查看当前所有已安装包及其版本
变更追踪：结合 Windows Event Log，可以追踪所有软件安装和卸载事件
合规报告：使用 choco outdated 定期生成软件版本合规性报告

# 生成系统软件清单报告

choco list --local-only --limit-output | Out-File -FilePath "C:\reports\software-inventory-$(Get-Date -Format 'yyyyMMdd').csv"

# 查看最近安装/变更记录

Get-Content "C:\ProgramData\chocolatey\logs\chocolatey.log" -Tail 100

6.5 团队共享与协作

在企业团队环境中，Chocolatey 的最佳实践包括：

共享 packages.config：将标准化的 packages.config 文件纳入版本控制（Git），团队统一使用
内部包源：搭建私有 NuGet 服务器，发布经审批的内部软件包
审批流程：结合 CI/CD 实现包的提交审核、自动构建、安全扫描、发布上线的完整流程
版本规范化：制定内部包的命名规范（如 company-appname-version）和版本号策略
文档化：为每个内部包撰写使用文档和变更日志

企业部署建议

对大规模部署（100+ 台机器），建议：1) 使用 Chocolatey Central Management 统一管理所有客户端；2) 部署内部包源避免外部依赖；3) 建立测试-预发布-生产三级环境；4) 通过 GPO 或配置管理工具推送 Chocolatey 配置；5) 定期审计和更新软件包。

七、维护与最佳实践

7.1 自动更新策略

建立科学的自动更新策略，确保系统软件始终保持安全和稳定：

# 使用计划任务实现定时自动更新

# 创建每日凌晨自动升级的任务

$action = New-ScheduledTaskAction -Execute "choco" -Argument "upgrade all -y"

$trigger = New-ScheduledTaskTrigger -Daily -At "03:00AM"

$principal = New-ScheduledTaskPrincipal -UserId "SYSTEM" -LogonType ServiceAccount

Register-ScheduledTask -TaskName "ChocolateyAutoUpgrade" -Action $action -Trigger $trigger -Principal $principal

# 仅升级安全更新（仅升级标记为安全更新的包）

# 注意：需配合自定义包标签筛选

choco upgrade all --except="nodejs,python" -y

7.2 缓存清理

Chocolatey 会在操作过程中缓存下载的安装包，长期积累会占用大量磁盘空间。定期清理缓存是维护的重要环节：

# 查看当前缓存大小

Get-ChildItem (choco config get cacheLocation).Value -Recurse | Measure-Object -Property Length -Sum

# 清理所有缓存

choco clean

# 清理特定类型的缓存

choco clean --downloads     # 仅清理下载缓存

choco clean --packages     # 仅清理包缓存

choco clean --all           # 清理所有缓存

# 手动清除缓存目录

$cacheDir = (choco config get cacheLocation).Value

Remove-Item "$cacheDir\*" -Recurse -Force

7.3 安全策略

使用 Chocolatey 时，需要重视安全性：

校验和验证：确保 checksumFiles 特性保持开启（默认开启），验证下载文件的哈希值
安全源：仅信任经过验证的包源，避免使用不可信的第三方源
包审查：在安装前使用 choco info 查看包的详细信息，包括作者、下载量、版本历史
最低权限原则：仅在需要时以管理员身份运行 choco，日常使用考虑使用用户级安装选项
HTTPS 传输：确保包源使用 HTTPS 而非 HTTP 传输
签名的包：Chocolatey 商业版支持代码签名验证，确保包未被篡改

安全注意事项：Chocolatey 的安装脚本以管理员权限运行，因此在安装第三方包之前，建议审查其 chocolateyInstall.ps1 脚本内容。社区源的大多数流行包经过社区审核，但仍有必要保持安全警惕。对于企业环境，强烈建议使用内部化（Internalize）后的包，确保所有依赖文件在可控范围内。

7.4 可靠性考虑

超时设置：对于大体积包的安装，适当增加 commandExecutionTimeoutSeconds 配置值
失败重试：在自动化脚本中添加 choco 命令的重试逻辑，因为网络波动可能导致下载失败
依赖管理：安装前确认所有依赖包在网络源中可用，或已提前内部化
并行限制：大批量安装时注意控制并发数，避免资源竞争
快照备份：在重大批量操作前，使用系统还原点或虚拟机快照备份状态

# 带重试逻辑的安装脚本示例

$maxRetries = 3

$retryDelay = 10 # 秒

for ($i = 1; $i -le $maxRetries; $i++) {

    try {

        choco install vscode -y --timeout=600

        Write-Host "安装成功" -ForegroundColor Green

        break

    } catch {

        if ($i -lt $maxRetries) {

            Write-Warning "第 $i 次尝试失败，$retryDelay 秒后重试..."

            Start-Sleep -Seconds $retryDelay

        } else {

            Write-Error "所有 $maxRetries 次尝试均失败"

        }

    }

}

7.5 日常维护清单

每日/每周：执行 choco outdated 检查可更新的软件包
每周：执行 choco clean 清理下载缓存和临时文件
每月：执行 choco upgrade all -y 更新所有软件包
每季：检查 Chocolatey 自身版本并升级 choco upgrade chocolatey
每半年：审计所有已安装包列表，移除不再需要的包
每年：审查内部包源中的包，更新文档和安全策略

八、与 Claude Code 的结合

8.1 在 Claude Code 中使用 Chocolatey

Claude Code 作为 AI 编程助手，可以结合 Chocolatey 实现 Windows 开发环境的自动化配置。通过 Claude Code 对话，你可以用自然语言描述需求，由 Claude Code 自动生成并执行 Chocolatey 命令：

# 在 Claude Code 中可以直接执行 choco 命令

choco install nodejs python git vscode -y

# Claude Code 会根据需求自动选择合适的包和版本

# 用户：帮我配置一个 Python 开发环境

# Claude Code 会执行：

choco install python vscode git -y

choco install vscode-python --params="/ExtensionPath:%USERPROFILE%\.vscode\extensions"

8.2 开发环境一键配置

结合 Claude Code 和 Chocolatey，可以实现开发环境的一键配置。Claude Code 可以根据项目类型自动判断需要的工具链，并使用 Chocolatey 安装：

# JavaScript/Node.js 开发环境配置

choco install nodejs-lts vscode git -y

npm install -g yarn pnpm

# Python 数据科学环境配置

choco install python anaconda3 vscode -y

pip install numpy pandas matplotlib jupyter

# C#/.NET 开发环境配置

choco install dotnet-sdk visualstudio2022community -y

# Go 开发环境配置

choco install golang vscode -y

8.3 使用 Chocolatey 安装 Claude Code 所需的工具

Claude Code 在 Windows 上可以充分利用 Chocolatey 安装各种辅助工具：

# 安装 Claude Code 常用的 Windows 工具

# 版本控制

choco install git.install -y --params="'/GitOnlyOnPath /NoAutoCrlf /NoGitLfs'"

# 终端增强

choco install microsoft-windows-terminal powershell-core -y

# 包管理器相关

choco install nuget.commandline -y

# 开发工具

choco install nodejs-lts python vscode -y

# 数据库工具

choco install sqlite -y

8.4 Chocolatey 包的自定义和管理

通过 Claude Code，可以用自然语言描述包的需求，让 Claude Code 协助完成包的创建、修改和发布流程：

创建包模板：让 Claude Code 根据你的软件需求生成 .nuspec 和安装脚本模板
编写安装脚本：Claude Code 理解 Chocolatey 辅助函数 API，可以编写正确的安装/卸载脚本
自动化工作流：让 Claude Code 生成 CI/CD 配置文件，实现包的自动构建和发布
排查问题：当 Chocolatey 安装失败时，可以分析日志并给出解决方案

Claude Code + Chocolatey 实践技巧

在 Claude Code 中管理 Chocolatey 时，可以使用以下技巧：
1. 先用 --noop 参数预览操作，确认无误后再执行真实操作
2. 使用 choco info 获取包的详细信息，帮助 Claude Code 理解包的功能
3. 批量操作时使用 packages.config 文件，便于 Claude Code 理解和修改
4. 遇到安装失败时，将 Chocolatey 日志提供给 Claude Code 进行分析

九、核心要点总结

Chocolatey 学习要点

Windows 包管理的基石：Chocolatey 是 Windows 平台上最成熟的第三方包管理器，基于 NuGet 基础设施构建，使用 PowerShell 脚本驱动，十一年来始终是 Windows 自动化的核心工具
与竞品的差异化：相比 winget（Microsoft 官方，适合普通用户）和 Scoop（便携式，适合开发者），Chocolatey 在企业级功能、离线支持和配置管理集成方面具有明显优势
安装环境配置：管理员 PowerShell 执行官方安装脚本，注意设置执行策略、代理环境，安装目录默认为 C:\ProgramData\chocolatey
核心命令体系：choco install/uninstall/upgrade（生命周期）、list/search/info/outdated（查询）、pin/feature/config/source（管理），构成完整的软件管理矩阵
进阶操作技巧：版本锁定（pin）、参数传递（--params/--installargs）、并行安装、packages.config 配置文件、预览模式（--noop）等高级用法大幅提升效率
包创建标准化：.nuspec 元数据 + chocolateyInstall.ps1 安装脚本 + NuGet 包结构，利用辅助函数实现标准化安装流程
企业级部署方案：离线安装（Package Internalizer）、GPO 集成、配置管理工具（Ansible/Puppet/Chef/DSC）、内部包源、审计日志构成完整的企业解决方案
安全与维护：校验和验证、安全源选择、缓存清理、定期更新、失败重试机制，建立科学的日常维护清单
Claude Code 集成：在 AI 编程助手中通过 Chocolatey 实现 Windows 开发环境自动配置，用自然语言管理软件包生命周期
工程化实践：将 packages.config 纳入版本控制，通过 CI/CD 自动化构建和发布内部包，建立测试-预发布-生产三级环境

结语：Chocolatey 是 Windows 系统管理员和开发者的重要工具，它将 Linux 包管理的便利性带到了 Windows 世界。掌握 Chocolatey 的核心命令、包创建流程和企业级部署方案，可以显著提升 Windows 软件管理的效率和可靠性。结合 Claude Code 等 AI 工具，Chocolatey 的潜力将得到进一步释放，实现真正的智能化系统管理。