PowerShell Invoke-WebRequest 报错排查与修复指南
在 Windows 运维或自动化部署中，Invoke-WebRequest 是获取远程资源的常用手段。新手经常遇到 Invalid URL（URL 无效）和 CommandNotFound（命令未找到）这两类报错。很多时候，后者其实是前者的连锁反应——因为 URL 错了，脚本没下载下来，自然找不到文件。下面结合实战经验，把这两个问题的根源和解决办法理清楚。
一、先看看错误长什么样
假设你在管理员模式的 PowerShell 里敲下这行命令：
Invoke-WebRequest -Uri "https://cdn.jsdelivr.net/gh/OpenClawChinese/main/install.ps1" -OutFile "install.ps1"; .\install.ps1
如果 URL 写错（比如把 jsdelivr 拼成 jsdelivrvr），或者本地没权限，通常会看到类似这样的报错堆栈：
Invoke-WebRequest : Invalid URL. ...
.\install.ps1 : 无法将'.\\install.ps1'项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写...
二、为什么会报错？
1. Invalid URL 的常见原因
- 域名拼写错误：这是最高频的坑。比如把
jsdelivr.net多写了个v变成jsdelivrvr。 - 路径格式不对：jsDelivr 的标准格式是
https://cdn.jsdelivr.net/gh/用户名/仓库名@版本号/文件路径，少了@版本号或者层级乱了都会挂。 - 网络拦截：内网或代理环境下，如果没配好代理，PowerShell 解析不了外网域名。
2. CommandNotFound 的常见原因
- 脚本根本没下载成功：URL 错了，文件自然不存在。
- 执行策略限制：PowerShell 默认策略是
Restricted，会拦着不让跑本地脚本。 - 路径引用问题：当前目录不对，或者文件名大小写/特殊字符导致系统认不出来。
三、一步步修复
1. 修正 URL 并重新下载
先把浏览器打开目标链接试试，确认能访问再动手。注意这里有个细节，-UseBasicParsing 参数在旧版本 PowerShell 里很重要，能避开 IE 内核解析的问题。
# 清理可能残留的错误文件
Remove-Item -Path .\install.ps1 -ErrorAction SilentlyContinue
# 下载脚本（关键：URL 必须正确）
Invoke-WebRequest -Uri "https://cdn.jsdelivr.net/gh/OpenClawChinese/main/install.ps1" -OutFile "install.ps1" -UseBasicParsing
下载完别急着跑，先用 Test-Path 确认文件真的落盘了：
Test-Path .\install.ps1
返回 True 才算稳。
2. 搞定执行策略
如果文件有了还报错，大概率是策略拦着。临时改成 RemoteSigned 允许本地脚本运行：
