// Windows · 2026-05-10

Scoop 修改优化特供版：一键搭建 Windows 开发环境的终极方案

windows

引言：为什么需要这个特供版？

Scoop 作为 Windows 平台最受欢迎的命令行包管理器之一，凭借其“零污染”的设计理念（不写入注册表、不弹 UAC、自动处理环境变量），已经成为开发者重装系统后快速恢复工作环境的首选工具。然而，对于国内用户而言，原版 Scoop 存在几个显著的痛点：

  1. GitHub 访问困难：大量软件包托管在 GitHub 上，国内下载速度极慢甚至超时
  2. Bucket 冲突频繁：scoop update 使用 git pull 同步仓库，手动修改过 bucket 的用户经常遇到 commit 冲突
  3. 搜索性能瓶颈：原生 scoop search 在 PowerShell 中执行缓慢
  4. 缺少桌面集成：默认不创建快捷方式，卸载需手动清理

xrgzs/scoop 是一个专门针对上述痛点深度修改的 Scoop 特供版，通过第三方 hook 机制在不破坏原版架构的前提下，实现了智能加速、冲突规避和体验增强。配合其详细的开发环境搭建指南 ，可以在无需特殊网络环境的条件下，30 分钟内完成从裸机到全栈开发环境的部署。

一、核心特性解析

1. 智能下载加速（Hook 机制）

这是该版本最核心的改进。通过在下载流程中注入 hook，自动判断并替换下载链接为国内镜像源，无需替换任何 Bucket。

  • 基于 ISP 检测：自动识别网络环境，精准选择加速策略
  • 可自定义代理：支持设置私有 GitHub Proxy，如 scoop config GH_PROXY ghfast.top
  • 一键开关：遇到校验错误时可执行 scoop config URL_REPLACE false 临时关闭替换功能

2. 搜索性能优化

scoop search 命令的执行优先级被重新设计： scoop-search（Rust 编写的独立搜索工具） > PowerShell Core > Windows PowerShell

这意味着只要安装了 scoop-search，搜索速度将获得数量级的提升。

3. 无冲突更新机制

原版 Scoop 使用 git pull 同步 bucket，一旦用户手动修改过本地 bucket 就会触发 commit 冲突。特供版通过替代同步策略，彻底避免了手动解决冲突的繁琐操作。

4. 桌面与系统集成

  • 自动创建桌面快捷方式：安装脚本默认启用 scoop config DESKTOP_SHORTCUT true
  • 控制面板卸载入口：自动注册卸载程序，可通过控制面板卸载/重设应用，注册表项使用 scoop_ + 应用名称命名

5. 开箱即用的安装体验

安装脚本自动完成以下配置：

  • 安装并配置 7zip、git、aria2、scoop-search、gsudo
  • 对未安装 PowerShell 5.1 的系统自动安装 PowerShell 7.2
  • 支持管理员权限安装，自动修复 Scoop 文件 ACL 到当前用户
  • 仓库同步到 GitCode，方便国内用户更新规则

二、安装与切换指南

全新安装（推荐）

在 PowerShell 中执行一行命令即可（适配 PowerShell 2.0+，支持 Windows 7 SP1+）：

irm c.xrgzs.top/c/scoop | iex

Windows 7 SP1 或 PowerShell 2.0 环境使用兼容命令：

(New-Object System.Net.WebClient).DownloadString('http://c.xrgzs.top/c/scoop') | iex

从原版 Scoop 切换

如果已安装原版 Scoop，执行以下命令平滑迁移：

scoop config scoop_repo 'https://gitcode.com/xrgzs/scoop'
scoop config scoop_branch 'master'
scoop update

高级安装选项

场景 命令
精简安装（仅主程序+git+aria2） iex "& { $(irm c.xrgzs.top/c/scoop) } -Slim"
自定义安装路径 iex "& { $(irm c.xrgzs.top/c/scoop) } -ScoopDir 'D:\Scoop' -ScoopGlobalDir 'D:\ScoopGlobal'"
指定 GitHub 加速代理 iex "& { $(irm c.xrgzs.top/c/scoop) } -GitHubProxy 'https://ghfast.top'"
安装时附加指定软件 iex "& { $(irm c.xrgzs.top/c/scoop) } -Append xrok"

三、完整开发环境搭建实战

以下流程基于 xrgzs 的技术笔记 整理，覆盖从基础工具到多语言开发环境的完整配置。

阶段一：基础工具链

安装完成后，系统已具备 Git、7-Zip、Aria2 等基础工具。首先配置 Git：

git config --global user.name "Your Name"
git config --global user.email "youremail@example.com"
git config --global credential.helper store  # 记住密码

SSH 密钥配置（用于推拉代码）：

ssh-keygen -t ed25519
cat ~/.ssh/id_ed25519.pub  # 复制到 GitHub/Gitee SSH 设置中

GPG 签名配置（提交显示 Verified）：

gpg --full-generate-key
gpg --list-secret-keys --keyid-format=long
gpg --armor --export {key_id}  # 复制到平台 GPG 设置中

git config --global user.signingkey {key_id}
git config --global commit.gpgsign true

阶段二：终端环境升级

1. 安装 Windows Terminal

scoop install extras/windows-terminal
reg import "$(scoop prefix windows-terminal)\install-context.reg"

2. 升级到 PowerShell Core

scoop install gsudo
gsudo scoop install sdoog/pwsh-np
scoop uninstall pwsh-np  # 清理

3. 安装 Nerd Font 与美化

scoop install nerd-fonts/Cascadia-Code
# 在 Windows Terminal 配置中设置字体为 "Cascadia Code NF"

4. Shell 增强

PowerShell 补全体系：

Install-Module PSCompletions -Repository PSGallery -Force
Install-Module CompletionPredictor -Repository PSGallery -Force
scoop install extras/scoop-completion extras/posh-git sdoog/argc

# 美化提示符（二选一）
scoop install oh-my-posh   # 方案A：Oh My Posh
scoop install starship     # 方案B：Starship

CMD 增强（可选）：

scoop install busybox clink clink-completions
clink autorun install
clink set clink.autoupdate off

阶段三：编辑器与 IDE

Visual Studio Code：

scoop install vscode
reg import "$(scoop prefix vscode)\install-context.reg"
reg import "$(scoop prefix vscode)\install-associations.reg"

建议关闭自动更新（由 Scoop 统一管理）：

{
  "update.enableWindowsBackgroundUpdates": false,
  "update.mode": "none"
}

Neovim（配合 LazyVim）：

scoop install neovim extras/neovide
reg import "$(scoop prefix neovide)\install-context.reg"

# 安装 LazyVim 配置
Move-Item "$env:LOCALAPPDATA\nvim" "$env:LOCALAPPDATA\nvim.bak"
git clone "https://gh.xrgzs.top/https://github.com/LazyVim/starter" "$env:LOCALAPPDATA\nvim"
Remove-Item "$env:LOCALAPPDATA\nvim\.git" -Recurse -Force
nvim  # 首次启动自动安装插件

JetBrains 全家桶：

scoop install extras/idea-ultimate extras/pycharm-professional extras/phpstorm
scoop install extras/goland extras/rider extras/clion extras/rustrover
scoop install extras/webstorm extras/rubymine extras/datagrip

阶段四：编程语言环境

Python 开发环境（2026 年强烈推荐 uv）

scoop install uv

# 配置国内镜像
$Env:UV_DEFAULT_INDEX = "https://mirrors.tuna.tsinghua.edu.cn/pypi/simple"
[Environment]::SetEnvironmentVariable("UV_DEFAULT_INDEX", $Env:UV_DEFAULT_INDEX, "User")

$Env:UV_PYTHON_INSTALL_MIRROR = "https://mirror.nju.edu.cn/github-release/astral-sh/python-build-standalone"
[Environment]::SetEnvironmentVariable("UV_PYTHON_INSTALL_MIRROR", $Env:UV_PYTHON_INSTALL_MIRROR, "User")

uv python install 3.14
uv python update-shell

传统方案（Miniconda）：

scoop install extras/miniconda3
# 配置 .condarc 使用清华镜像

Node.js 开发环境

scoop install nodejs-lts  # 或 nodejs 最新版
npm config set registry https://registry.npmmirror.com
scoop install pnpm
npm config set script-shell bash  # 解决 package.json 中 POSIX shell 脚本兼容问题

Java 开发环境

scoop install java/openjdk maven gradle

# Maven 换源（南京大学镜像）
$Env:M2_HOME = "$(scoop prefix maven)"
[Environment]::SetEnvironmentVariable("M2_HOME", $Env:M2_HOME, "User")
# 写入 $M2_HOME/conf/settings.xml

# Gradle 换源
$Env:GRADLE_HOME = "$(scoop prefix gradle)"
[Environment]::SetEnvironmentVariable("GRADLE_HOME", $Env:GRADLE_HOME, "User")
# 写入 $(scoop prefix gradle)\init.d\init.gradle

C/C++ 开发环境（MSYS2 方案）

scoop install dorado/msys2-cn

# 将 UCRT64 加入用户 PATH
[Environment]::SetEnvironmentVariable("PATH", "$(scoop prefix msys2-cn)\ucrt64\bin;" + [Environment]::GetEnvironmentVariable("PATH", "User"), "User")

# 安装 GCC 工具链
ucrt64 -c "pacman --noconfirm -S mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-cmake"

# 关闭 Scoop 对 MSYS2 的升级（pacman 自行管理）
scoop hold msys2-cn

数据库环境

# MySQL
scoop install mysql mysql-shell

# PostgreSQL
scoop install postgresql

Android 开发环境

scoop install extras/android-studio

# 方式一：Scoop 管理 SDK（适合 D 盘安装）
scoop install android-clt
# 需在 Android Studio 中确认 SDK Location 指向 scoop prefix 路径

# 方式二：自定义 SDK 目录（推荐）
$Env:ANDROID_HOME = "D:\Android\Sdk"
[Environment]::SetEnvironmentVariable("ANDROID_HOME", $Env:ANDROID_HOME, "User")
mkdir $Env:ANDROID_HOME
# 在 Android Studio 中安装 SDK 到该目录

四、配置管理与备份

Scoop 提供了强大的导出/导入功能，实现环境快速迁移：

# 导出当前环境
scoop export > scoopfile.json

# 在新机器上恢复
scoop import .\scoopfile.json

常用维护命令：

scoop status -l          # 查看可更新应用
scoop update *           # 更新所有应用
scoop hold <app>         # 禁止更新某应用（如 MSYS2）
scoop reset <app>        # 切换版本（如 python310 / python38）
scoop uninstall -p <app> # 彻底卸载并清除数据
scoop cache rm *         # 清理下载缓存

五、总结与建议

xrgzs/scoop 特供版通过非侵入式的 hook 设计，在不破坏 Scoop 原有生态的前提下，解决了国内用户最棘手的网络加速、仓库冲突和桌面集成问题。其价值不仅在于单个工具的优化，更在于提供了一套可复现、可版本控制、可快速迁移的 Windows 开发环境管理方案。

对于追求极致效率的开发者，建议：

  1. 使用 scoop export 定期备份环境配置
  2. 将 scoopfile.json 纳入 dotfiles 仓库进行版本控制
  3. 配合 Windows Terminal + PowerShell Core + Oh My Posh/Starship 打造现代化终端体验
  4. 多版本语言环境（Python/Node/Java）通过 Scoop 的 reset 机制灵活切换

项目地址：https://github.com/xrgzs/scoop 详细搭建指南：https://www.xrgzs.top/posts/scoop-dev-setup

原文 https://blog.csdn.net/2301_79518550/article/details/160961926