问题描述与常见排查
在使用 gdown 工具从 google drive 下载文件时，windows 用户可能会遇到以下错误信息，即使他们已经通过 pip 安装了 gdown 并确认其版本，甚至将 python 的 scripts 目录添加到了系统的 path 环境变量中：
gdown : The term 'gdown' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
此错误表明操作系统无法在当前执行环境中找到名为 gdown 的可执行文件或脚本。常见的排查步骤包括：
-
确认 gdown 已安装： 通过运行 pip show gdown 命令来验证 gdown 是否已成功安装及其版本信息。
pip show gdown
如果显示类似以下内容，则表示安装成功：
Name: gdown Version: 4.7.1 Summary: Google Drive direct download of big files. ... Location: C:\Users\myname\AppData\Roaming\Python\Python312\site-packages ...
检查 PATH 环境变量： 确保包含 gdown 可执行文件（通常是 gdown.exe 或 gdown 启动脚本）的目录已添加到系统的 PATH 环境变量中。对于通过 pip install --user 安装的包，其脚本通常位于 C:\Users\
\AppData\Roaming\Python\Scripts。对于特定 Python 环境，则在 \Scripts。
尽管执行了上述步骤，问题可能依然存在，这通常是由于系统查找可执行文件的机制与 gdown 实际安装位置或其启动方式之间存在不匹配。
解决方案：直接定位并执行
当 PATH 环境变量未能如预期工作时，最直接有效的解决方案是明确指定 gdown 可执行文件或其启动脚本的路径。
步骤一：确定 gdown 脚本的实际位置
首先，需要找到 gdown 命令的实际入口点。虽然 pip show gdown 显示的是包的安装位置（site-packages），但其可执行脚本通常位于与该 Python 环境关联的 Scripts 目录中。
-
查找 Scripts 目录： 通常，如果 gdown 是通过 pip install --user 安装的，其脚本会位于： C:\Users\
\AppData\Roaming\Python\Scripts 如果是在特定 Python 环境（如 Anaconda 或虚拟环境）中安装，则会在该环境的根目录下找到 Scripts 文件夹，例如： C:\Program Files\Python312\Scripts 或 C:\Users\ \Anaconda3\envs\ \Scripts 您可以手动浏览这些目录，查找名为 gdown.exe、gdown.bat 或 gdown 的文件。
步骤二：导航至该目录并在本地执行
一旦确定了 gdown 脚本所在的目录，请在终端（PowerShell、CMD 或 Git Bash）中导航到该目录，然后使用相对路径执行 gdown 命令。
-
打开终端并切换目录： 假设 gdown 的脚本位于 C:\Users\myname\AppData\Roaming\Python\Scripts，您应执行以下命令：
cd C:\Users\myname\AppData\Roaming\Python\Scripts
-
执行 gdown 命令： 在该目录下，使用 .\gdown 前缀来明确指示执行当前目录下的 gdown 脚本。
.\gdown https://drive.google.com/uc?id=YOUR_FILE_ID
请将 YOUR_FILE_ID 替换为实际的 Google Drive 文件 ID。
示例： 如果您要下载一个 ID 为 1hs9HM0XJ2LPFghcn7ZMOs5qu5HexPXw 的文件，并且 gdown 脚本位于上述用户 Scripts 目录，完整的操作流程如下：
# 1. 打开 PowerShell 或 CMD # 2. 切换到 gdown 脚本所在的目录 cd C:\Users\myname\AppData\Roaming\Python\Scripts # 3. 执行 gdown 命令 .\gdown https://drive.google.com/uc?id=1hs9HM0XJ2LPFghcn7ZMOs5qu5HexPXw
注意事项与总结
- 路径的准确性： 确保 cd 命令中的路径与您系统中 gdown 脚本的实际位置完全匹配。AppData 文件夹默认是隐藏的，可能需要显示隐藏文件才能找到。
- .\ 的作用： 在 Windows 终端中，.\ 前缀表示在当前目录下查找并执行可执行文件或脚本。这绕过了 PATH 环境变量的搜索机制，直接指定了执行目标。
- 长期解决方案： 虽然上述方法可以立即解决问题，但更长期的解决方案是确保包含 gdown 脚本的 正确 Scripts 目录被永久添加到 PATH 环境变量中。如果问题反复出现，可能需要检查 PATH 变量的配置是否正确，或者是否有多个 Python 版本导致冲突。
-
替代方法： 作为一种通用且通常更可靠的执行 Python 包内脚本的方法，您也可以尝试使用 python -m gdown 命令，它会通过 Python 解释器直接运行 gdown 模块。
python -m gdown https://drive.google.com/uc?id=YOUR_FILE_ID
这种方法不需要 gdown 脚本在 PATH 中，只要 python 命令本身在 PATH 中即可。
通过理解 gdown 命令未识别的根本原因，并采用直接定位执行的方法，用户可以有效解决在 Windows 环境下使用 gdown 时遇到的 CommandNotFoundException 错误，从而顺利完成文件下载任务。
