news 2026/4/23 19:08:38

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

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
一键配置 Web 前端开发环境（PowerShell 自动化脚本）

前言

💡 最近重装系统后发现重新配置前端开发环境太繁琐，于是写了个 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 版本隔离与统一

支持交互选择可选软件，灵活方便

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/4/23 3:55:55

【MPC】模型预测控制(MPC)之多变量和状态空间研究附Matlab代码

✅作者简介：热爱科研的Matlab仿真开发者，擅长数据处理、建模仿真、程序设计、完整代码获取、论文复现及科研仿真。🍎 往期回顾关注个人主页：Matlab科研工作室🍊个人信条：格物致知,完整Matlab代码及仿真咨询…

作者头像 李华
网站建设 2026/4/23 11:47:57

Java毕设项目：基于springboot的汽车租赁买卖管理系统的设计与实现(源码+文档，讲解、调试运行，定制等)

博主介绍：✌️码农一枚 ，专注于大学生项目实战开发、讲解和毕业🚢文撰写修改等。全栈领域优质创作者，博客之星、掘金/华为云/阿里云/InfoQ等平台优质作者、专注于Java、小程序技术领域和毕业项目实战 ✌️技术范围：&am…

作者头像 李华
网站建设 2026/4/23 12:58:11

神经网络和深度学习 第四周：深度神经网络的关键概念

周为第一课的最后一周内容，就像标题一样，我们从第二周的逻辑回归，到第三周的浅层神经网络， 再到本周的深度神经网络的概念层层递进，第一课内容主要还是对神经网络框架的基本介绍，因此本周实际上的主要内容还…

作者头像 李华
网站建设 2026/4/23 12:56:46

【打造自己的 DeepSeek】第 1 期：为什么要打造自己的 DeepSeek？ _

个人认为有两方面原因：一方面是 DeepSeek 使用方便。由于众所周知的原因，国内对国外网站的访问是有诸多限制的，其中就包括各大 AI 模型的官网。而 DeepSeek 是国内研发的，可以直接访问，网页使用是非常方便的。而且 Dee…

作者头像 李华
网站建设 2026/4/23 13:58:46

达梦数据库与部分的联动使用

介绍达梦数据库概述达梦数据库（DM Database）是由武汉达梦数据库股份有限公司研发的国产大型关系型数据库管理系统（RDBMS），具备自主知识产权，广泛应用于政务、金融、能源、电信等关键领域，是国内…

作者头像 李华