用途:当用户处于 Windows 环境、要求 PowerShell 命令,或需要原生 Windows 安装与排障而非 Bash 或 WSL 时使用本技能。
Shell 选择:已安装 PowerShell 7 时优先使用 pwsh;需要内置 Windows PowerShell 兼容性时使用 powershell.exe。在文档中应使用标记为 powershell 的代码块,避免使用 && 等仅限 Bash 的运算符,除非明确在 WSL/Git Bash 中运行。
只读检查:可使用 $PSVersionTable.PSVersion;用 Get-Command node, npm, git, python, rg -ErrorAction SilentlyContinue 检查命令是否存在;用 node --version、npm --version、git --version、python --version、rg --version 查看版本。
路径检查:Get-Location、Get-ChildItem、Resolve-Path .、$env:PATH -split ';'。
顺序执行命令时逐行书写,例如先 Set-Location C:\path\to\PilotDeck,再 node --version、corepack enable、corepack pnpm install --frozen-lockfile。当 PowerShell 执行策略阻止 .ps1 垫片时,改用 npm.cmd 或 pnpm.cmd,如 npm.cmd --version、pnpm.cmd --version。
原生 Windows 说明:源码安装在原生 Windows 上需要 Node.js 22、Git/Git LFS、Python、Visual Studio C++ Build Tools 与 ripgrep。开发通常用 WSL2 更简单,但原生 PowerShell 也受支持。可用 winget 安装常见前置依赖:winget install OpenJS.NodeJS.LTS、Git.Git、GitHub.GitLFS、Python.Python.3.12、BurntSushi.ripgrep.MSVC,以及 Microsoft.VisualStudio.2022.BuildTools 并附加 VCTools 工作负载。安装后需关闭并重新打开 PowerShell 使 PATH 生效。
安全:对 Remove-Item -Recurse -Force 等破坏性命令要谨慎,先确认目标路径;除非用户明确要求并理解风险,避免全局更改执行策略;优先使用项目级或会话级更改而非机器级更改。