Windows下pipreqs指定路径仅显示用法无法生成requirements.txt问题

问题现象 #

• 按格式传入项目绝对路径调用pipreqs时，工具未生成目标依赖文件，仅输出用法提示：

(WebScraping) G:\>pipreqs G:\PY CODE\WebScraping
Usage:
    pipreqs [options] [<path>]

• 传入不存在的路径参数时，工具抛出文件不存在的Traceback报错：

(WebScraping) G:\>pipreqs s
Traceback (most recent call last):
File "D:\anaconda\envs\WebScraping\lib\runpy.py", line 196, in _run_module_as_main
return _run_code(code, main_globals, None,
File "D:\anaconda\envs\WebScraping\lib\runpy.py", line 86, in _run_code
exec(code, run_globals)
File "D:\anaconda\envs\WebScraping\Scripts\pipreqs.exe\__main__.py", line 7, in <module>
File "D:\anaconda\envs\WebScraping\lib\site-packages\pipreqs\pipreqs.py", line 488, in main
init(args)
File "D:\anaconda\envs\WebScraping\lib\site-packages\pipreqs\pipreqs.py", line 478, in init
generate_requirements_file(path, imports, symbol)
File "D:\anaconda\envs\WebScraping\lib\site-packages\pipreqs\pipreqs.py", line 157, in generate_requirements_file
with _open(path, "w") as out_file:
File "D:\anaconda\envs\WebScraping\lib\contextlib.py", line 135, in __enter__
return next(self.gen)
File "D:\anaconda\envs\WebScraping\lib\site-packages\pipreqs\pipreqs.py", line 81, in _open
file = open(filename, mode)
FileNotFoundError: [Errno 2] No such file or directory: 's\requirements.txt'

• 仅当先切换工作目录到项目根路径，执行不带路径参数的pipreqs命令时，才能成功生成requirements.txt：

(WebScraping) G:\PY CODE\WebScraping>pipreqs --encoding=utf8
INFO: Successfully saved requirements file in G:\PY CODE\WebScraping\requirements.txt

故障原因 #

核心原因是传入的项目路径包含空格（G:\PY CODE\WebScraping中PY和CODE之间存在空格）。Windows命令行默认将空格作为参数分隔符，未加引号包裹带空格的路径时，pipreqs实际仅接收到G:\PY作为路径入参，CODE\WebScraping被识别为无效的额外参数，因此触发用法提示，不会执行依赖扫描逻辑。
传入不存在路径时报错是pipreqs的正常逻辑：工具不会自动创建不存在的目录，写入requirements.txt时会直接触发文件找不到错误。

正确调用方式 #

• 传入带空格的路径时，用双引号将完整路径包裹，建议同时指定utf8编码避免Windows环境下的编码解析错误，执行命令：

pipreqs "G:\PY CODE\WebScraping" --encoding=utf8

• 传入路径前确认目标项目目录真实存在，路径错误会直接触发FileNotFoundError。
• 命令执行后输出INFO: Successfully saved requirements file in 对应路径提示，即代表依赖文件正常生成。

内容的提问来源于stack exchange，提问作者user19374775