如何轻松解决 PowerShell Invoke-WebRequest 中的“Illegal Characters in Path”错误？

2024-03-09 14:39:56

如何解决 Invoke-WebRequest 中的“Illegal Characters in Path”错误：一份全面的指南

作为一名程序员，我经常使用 PowerShell 来执行各种任务，包括从 Web 下载文件。然而，我最近遇到了一个令人困惑的错误：“Illegal characters in path”。经过一番调查，我发现了导致此错误的根本原因和解决方法。

错误原因

此错误通常发生在使用 Split-Path 命令从 URL 中提取文件名，然后在 Invoke-WebRequest 命令中指定 -OutFile 参数时。Split-Path 命令将路径或 URI 作为输入，并返回一个包含路径各个组成部分（如文件名）的对象。当使用 Split-Path -Leaf 命令时，它将返回文件的完整名称（包括扩展名）。

在 Invoke-WebRequest 命令中，Split-Path -Leaf 命令的输出被包裹在引号 (") 中。引号会将输出解释为一个字符串，其中包含文件名和一个尾随空格。当将此字符串传递给 -OutFile 参数时，PowerShell 会将尾随空格解释为路径的一部分，从而导致 “Illegal characters in path” 错误。

解决方案

为了解决此问题，我们需要确保 Split-Path 命令的输出不包含尾随空格。有两种方法可以做到这一点：

使用 -trim 操作符： -trim 操作符可用于删除字符串末尾的空格。以下命令将修剪 Split-Path -Leaf 命令的输出：

Invoke-WebRequest -OutFile "$(Split-Path -Leaf ${file_url}).trim()" "${file_url}"

使用 Split-Path -Leaf $file_url： 直接将 Split-Path -Leaf 命令的输出传递给 Invoke-WebRequest 命令的 -OutFile 参数，而无需使用引号，也能确保输出不会包含尾随空格：

Invoke-WebRequest -OutFile $(Split-Path -Leaf $file_url) "${file_url}"

示例

以下是一个完整的示例，说明如何使用 Split-Path 命令从 URL 中提取文件名，并使用 Invoke-WebRequest 命令下载文件：

$file_url = "https://github.com/vsajip/python-gnupg/releases/download/0.5.2/python_gnupg-0.5.2-py2.py3-none-any.whl"
Invoke-WebRequest -OutFile $(Split-Path -Leaf $file_url).trim() "${file_url}"