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

技术分享 5个月前 (10-24) 0 999+

关注

前言

💡 最近重装系统后发现重新配置前端开发环境太繁琐，于是写了个 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:ProgramFilesPowerShell7pwsh.exe",             "$env:ProgramFilesPowerShell7-previewpwsh.exe",             "$env:ProgramFiles(x86)PowerShell7pwsh.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。