前言
💡 最近重装系统后发现重新配置前端开发环境太繁琐，于是写了个 PowerShell 自动化脚本，
可以在 Windows 系统 下，一键完成常用开发工具的安装与配置，让你重装系统后快速开工！
✨ 功能简介
这个脚本支持以下功能👇：
✅ 自动检测并安装 PowerShell 7+
✅ 自动检测并安装 Git、VS Code、Volta
✅ 自动配置环境变量（例如 VOLTA_FEATURE_PNPM）
✅ 使用 Volta 安装 Node.js 与 pnpm
✅ 支持交互式选择安装可选软件（Snipaste、Chrome、Firefox、QQ、微信）
✅ 自动刷新环境变量，无需手动配置 PATH
📦 支持的工具列表
类别 工具 说明
基础工具 PowerShell 7+ 现代化 PowerShell 运行环境
版本管理 Volta Node.js / pnpm 管理工具
开发工具 Git、Visual Studio Code 前端开发必备
可选软件 Snipaste、Chrome、Firefox、QQ、微信 可交互选择安装
⚙️ 使用方式
1️⃣ 下载脚本
创建一个文件，例如 web-env-setup.ps1，然后将下面的脚本内容复制进去 👇
# 设置脚本在出错时停止
$ErrorActionPreference = "Stop"
# 使用 Winget 判断软件是否以安装
function Installed {
param (
[string]$packageId
)
try {
# 屏蔽 winget 的错误输出，使用 -SimpleMatch 避免正则，-Quiet 返回布尔
$found = winget list --id $PackageId 2>$null | Select-String -SimpleMatch -Quiet $PackageId
return [bool]$found
}
catch {
# 如果 winget 不存在或运行失败，返回 $false（也可以选择写日志或抛出错误）
return $false
}
}
# 使用 winget 安装软件
function WingetInstall {
param(
[Parameter(Mandatory = $true)][string]$PackageId,
[Parameter(Mandatory = $false)][string]$DisplayName = $PackageId
)
$installCmd = "winget install $PackageId --accept-source-agreements --accept-package-agreements -e"
Write-Log "🔧 使用 winget 安装 $DisplayName..." "Cyan"
Invoke-Expression $installCmd
if ($LASTEXITCODE -ne 0) {
Write-Log "❌ 使用 winget 安装 $DisplayName 失败（ExitCode=$LASTEXITCODE）。" "Red"
}
else {
Write-Log "✅ 已通过 winget 安装 $DisplayName 成功。" "Green"
}
}
# -------------------------
# PowerShell 版本检查与自动安装（确保运行在 PowerShell 7+）
function Restart-InPwsh7IfNeeded {
$CurrentMajor = $PSVersionTable.PSVersion.Major
if ($CurrentMajor -ge 7) { return $false }
Write-Host "⚠️ 当前会话为 PowerShell 小于 7，检测系统中是否已安装 PowerShell 7+..." -ForegroundColor Yellow
# 尝试从 PATH 查找 pwsh
$pwshPath = $null
$installedMajor = 0
$pwshCmd = Get-Command pwsh -ErrorAction SilentlyContinue
if ($pwshCmd) {
$pwshPath = $pwshCmd.Source
try { $installedMajor = & "$pwshPath" -NoProfile -Command '$PSVersionTable.PSVersion.Major' 2>$null | ForEach-Object { [int]$_ } } catch { $installedMajor = 0 }
}
# 如果 PATH 未找到，再检查常见目录
if (-not $pwshPath) {
$possible = @(
"$env:ProgramFiles\PowerShell\7\pwsh.exe",
"$env:ProgramFiles\PowerShell\7-preview\pwsh.exe",
"$env:ProgramFiles(x86)\PowerShell\7\pwsh.exe"
)
foreach ($p in $possible) {
if (Test-Path $p) {
try { $ver = & "$p" -NoProfile -Command '$PSVersionTable.PSVersion.Major' 2>$null | ForEach-Object { [int]$_ } } catch { $ver = 0 }
if ($ver -and $ver -gt 0) { $pwshPath = $p; $installedMajor = $ver; break }
}
}
}
# 如果找到了 7+，就用它重新启动脚本
if ($installedMajor -ge 7 -and $pwshPath) {
Write-Host "✅ 系统已安装 PowerShell $installedMajor，使用 $pwshPath 重新运行脚本。" -ForegroundColor Green
# 解析脚本路径：优先使用 $PSCommandPath（PowerShell 3+），回退到 MyInvocation
$scriptPath = $PSCommandPath
if (-not $scriptPath) { $scriptPath = $MyInvocation.MyCommand.Path }
$argsFromInvocation = @()
if ($MyInvocation.UnboundArguments) {
foreach ($item in $MyInvocation.UnboundArguments) {
if ($item -ne $null -and $item -ne '') { $argsFromInvocation += [string]$item }
}
}
$baseArgs = @('-NoProfile', '-ExecutionPolicy', 'Bypass', '-NoExit')
$argList = $baseArgs + @('-File', $scriptPath) + $argsFromInvocation
$argList = @($argList) | Where-Object { $_ -ne $null -and $_ -ne '' }
Start-Process -FilePath $pwshPath -ArgumentList $argList -Verb RunAs
return $true
}
else {
Write-Host "⚠️ 未找到 PowerShell 7，可手动安装后重试。" -ForegroundColor Yellow
return $false
}
}
# 如果需要安装并重启，则退出当前进程（新进程将接手）
if (Restart-InPwsh7IfNeeded) {
Write-Host "Exiting current process to allow PowerShell 7+ to handle the rest..." -ForegroundColor Cyan
exit 0
}
function Write-Log {
param(
[Parameter(Mandatory = $true)][string]$msg,
[string]$color = "White"
)
Write-Host $msg -ForegroundColor $color
}
Write-Log "`n⚙️ 检查并安装 Git..." "Cyan"
# 检测 git 是否安装
if (Installed 'Git.Git') {
Write-Log "✅ Git 已安装，跳过" "Green"
}
else {
Write-Log "⚠️ 未检测到 Git，尝试使用 winget 安装 Git..." "Yellow"
WingetInstall -PackageId 'Git.Git' -DisplayName 'Git'
# 刷新 PATH
$env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
}
Write-Log "`n⚙️ 检查并安装 Visual Studio Code..." "Cyan"
# 检测 vscode 是否安装
if (Installed 'Microsoft.VisualStudioCode') {
Write-Log "✅ Visual Studio Code (code) 已安装，跳过" "Green"
}
else {
Write-Log "⚠️ 未检测到 Visual Studio Code，尝试使用 winget 安装 VS Code..." "Yellow"
WingetInstall -PackageId 'Microsoft.VisualStudioCode' -DisplayName 'Visual Studio Code'
# 刷新 PATH
$env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
}
Write-Log "`n⚙️ 检测并安装 Volta ..." "Cyan"
# --------------------------
# 检查环境变量 VOLTA_FEATURE_PNPM
# --------------------------
$val = [System.Environment]::GetEnvironmentVariable("VOLTA_FEATURE_PNPM", "Machine")
if (-not $val) {
$val = [System.Environment]::GetEnvironmentVariable("VOLTA_FEATURE_PNPM", "User")
}
if ($val -eq "1") {
Write-Log "✅ VOLTA_FEATURE_PNPM 已设置，跳过" "Green"
}
else {
$isAdmin = ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltinRole]::Administrator)
if ($isAdmin) {
[System.Environment]::SetEnvironmentVariable("VOLTA_FEATURE_PNPM", "1", "Machine")
Write-Log "✅ 已设置系统级别的环境变量 VOLTA_FEATURE_PNPM = 1" "Green"
}
else {
[System.Environment]::SetEnvironmentVariable("VOLTA_FEATURE_PNPM", "1", "User")
Write-Log "⚠️ 未以管理员身份运行，已设置用户级别的环境变量 VOLTA_FEATURE_PNPM = 1" "Yellow"
}
}
if (Installed 'Volta.Volta') {
Write-Log "✅ Volta 已安装，跳过" "Green"
}
else {
Write-Log "⚠️ Volta 未安装，尝试使用 winget 安装 Volta..." "Yellow"
winget install Volta.Volta --accept-source-agreements --accept-package-agreements
if ($LASTEXITCODE -eq 0) {
Write-Log "✅ 已通过 winget 安装 Volta 成功" "Green"
# 尝试刷新 PATH 环境变量，使 volta 立即可用
$env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" +
[System.Environment]::GetEnvironmentVariable("Path", "User")
# 检查 volta 是否立即可用
if (!(Get-Command volta -ErrorAction SilentlyContinue)) {
Write-Log "⚠️ volta 暂不可用，可能需要重新打开终端。继续尝试执行安装..." "Yellow"
}
}
else {
Write-Log "❌ 使用 winget 安装 Volta 失败，请手动检查。" "Red"
}
}
# ==========================
# 使用 Volta 安装 NodeJS 和 pnpm
# ==========================
Write-Log "`n⚙️ 安装 NodeJS 和 pnpm ..." "Cyan"
$nodeInstalled = volta list node | Select-String "default" -ErrorAction SilentlyContinue
if ($nodeInstalled) {
Write-Log "✅ NodeJS 已安装，跳过" "Green"
}
else {
volta install node
if ($LASTEXITCODE -eq 0) {
Write-Log "✅ NodeJS 已通过 Volta 安装成功" "Green"
}
else {
Write-Log "❌ 使用 Volta 安装 NodeJS 失败，请手动检查 Volta 日志或终端输出。" "Red"
}
}
$pnpmInstalled = volta list pnpm | Select-String "default" -ErrorAction SilentlyContinue
if ($pnpmInstalled) {
Write-Log "✅ pnpm 已安装，跳过" "Green"
}
else {
volta install pnpm
if ($LASTEXITCODE -eq 0) {
Write-Log "✅ pnpm 已通过 Volta 安装成功" "Green"
}
else {
Write-Log "❌ 使用 Volta 安装 pnpm 失败，请手动检查 Volta 日志或终端输出。" "Red"
}
}
Write-Log "`n🎉 所有步骤完成！" "Green"
Write-Log "请重新打开终端以应用环境变量。" "Yellow"
# -------------------------
# 可选软件安装（通过 winget，交互式选择）
# 支持：通过环境变量 WEB_ENV_SETUP_INSTALL_OPTIONAL=1 跳过交互并自动安装所有可选软件
# -------------------------
Write-Log "`n⚙️ 可选软件安装（Snipaste, Chrome, Firefox, QQ, 微信）..." "Cyan"
$optionalPkgs = @(
@{ Id = 'liule.Snipaste'; Name = 'Snipaste'; },
@{ Id = 'Google.Chrome'; Name = 'Google Chrome'; },
@{ Id = 'Mozilla.Firefox'; Name = 'Mozilla Firefox'; },
@{ Id = 'Tencent.QQ'; Name = 'QQ'; },
@{ Id = 'Tencent.WeChat'; Name = 'WeChat'; }
)
function Show-MultiSelect {
param(
[Parameter(Mandatory = $true)][string[]]$Options,
[string]$Title = "请选择（上下键切换，空格选择，回车确认，Esc 取消）"
)
$selected = @()
for ($i = 0; $i -lt $Options.Count; $i++) { $selected += $false }
$cursor = 0
function RenderAll {
Clear-Host
Write-Host $Title -ForegroundColor Cyan
for ($i = 0; $i -lt $Options.Count; $i++) {
$mark = if ($selected[$i]) { '[√]' } else { '[ ]' }
if ($i -eq $cursor) { Write-Host "> $mark $($Options[$i])" -ForegroundColor Cyan } else { Write-Host " $mark $($Options[$i])" }
}
}
RenderAll
while ($true) {
$key = $Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown')
$vk = $key.VirtualKeyCode
$ch = $key.Character
# 兼容不同主机对回车/ESC的编码：CR(13)、LF(10)、ESC(27)
if ($vk -eq 13 -or $ch -eq "`r" -or $ch -eq "`n") { break }
if ($vk -eq 27 -or ([int][char]$ch) -eq 27) { $selected = @(); break }
switch ($vk) {
38 { if ($cursor -gt 0) { $cursor-- } else { $cursor = $Options.Count - 1 }; RenderAll } # Up
40 { if ($cursor -lt $Options.Count - 1) { $cursor++ } else { $cursor = 0 }; RenderAll } # Down
32 { $selected[$cursor] = -not $selected[$cursor]; RenderAll } # Space
default {
# 某些主机 Space 可能表现为字符而非 VK；再做一次字符判断
if ($ch -eq ' ') { $selected[$cursor] = -not $selected[$cursor]; RenderAll }
}
}
}
$result = @()
for ($i = 0; $i -lt $Options.Count; $i++) { if ($selected[$i]) { $result += $i } }
Write-Host ""
return $result
}
$names = $optionalPkgs | ForEach-Object { $_.Name }
$sel = $null
$sel = Show-MultiSelect -Options $names -Title "请选择要安装的可选软件（空格切换，回车确认）："
$selCount = $sel.Count
if ($null -eq $sel -or $selCount -eq 0) {
Write-Log "ℹ️ 未选择任何可选软件，跳过安装。" "Yellow"
}
else {
Write-Log "ℹ️ 开始安装选中软件..." "Yellow"
foreach ($i in $sel) {
$pkg = $optionalPkgs[$i]
# 再次检测路径
$found = winget list --id $pkg.Id | Select-String $pkg.Id
if ($found) { Write-Log "✅ 检测到 $($pkg.Name) 已安装，跳过安装。" "Green"; continue }
Write-Log "⚠️ 使用 winget 安装 $($pkg.Name)..." "Yellow"
WingetInstall -PackageId $pkg.Id -DisplayName $pkg.Name
}
}
# 刷新 PATH（尝试让新安装的应用生效）
$env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
if ($global:WebEnvLog) {
try { Stop-Transcript -ErrorAction SilentlyContinue } catch { }
Write-Host "日志已保存到：$global:WebEnvLog" -ForegroundColor Cyan
}
脚本已发布到 Github。
2️⃣ 运行脚本
右键点击脚本 → 选择 “使用 PowerShell 运行”
或者在 Powershell 命令行执行：
.\web-env-setup.ps1
🧩 小结
这份脚本非常适合重装系统后快速恢复前端开发环境
所有安装均通过 winget 官方包管理器完成
Volta 保证 Node 与 pnpm 版本隔离与统一
支持交互选择可选软件，灵活方便
