当前位置：首页 > news >正文

一键配置 Web 前端开发环境（PowerShell 自动化脚本）

news 2026/6/11 19:50:55

前言

💡 最近重装系统后发现重新配置前端开发环境太繁琐，于是写了个 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 $PackageIdreturn [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 $installCmdif ($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.Majorif ($CurrentMajor -ge 7) { return $false }Write-Host "⚠️ 当前会话为 PowerShell 小于 7，检测系统中是否已安装 PowerShell 7+..." -ForegroundColor Yellow# 尝试从 PATH 查找 pwsh$pwshPath = $null$installedMajor = 0$pwshCmd = Get-Command pwsh -ErrorAction SilentlyContinueif ($pwshCmd) {$pwshPath = $pwshCmd.Sourcetry { $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 = $PSCommandPathif (-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 RunAsreturn $true}else {Write-Host "⚠️ 未找到 PowerShell 7，可手动安装后重试。" -ForegroundColor Yellowreturn $false}
}# 如果需要安装并重启，则退出当前进程（新进程将接手）
if (Restart-InPwsh7IfNeeded) {Write-Host "Exiting current process to allow PowerShell 7+ to handle the rest..." -ForegroundColor Cyanexit 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-agreementsif ($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 nodeif ($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 pnpmif ($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 = 0function RenderAll {Clear-HostWrite-Host $Title -ForegroundColor Cyanfor ($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])" }}}RenderAllwhile ($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 } # Up40 { if ($cursor -lt $Options.Count - 1) { $cursor++ } else { $cursor = 0 }; RenderAll } # Down32 { $selected[$cursor] = -not $selected[$cursor]; RenderAll }                            # Spacedefault {# 某些主机 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.Countif ($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.Idif ($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。