如何制作Windows下pdoc的便携启动批处理文件？

方案1：直接调用Python模块（最简洁） #

不用硬编码pdoc.exe的绝对路径，直接通过Python模块方式启动pdoc，自动适配当前环境的Python解释器：

@echo off
py -3 -m pdoc my_package
pause

• py是Windows官方的Python启动器，会自动识别系统中的Python3环境；如果确认用户环境只有Python3，也可以替换成python -m pdoc my_package
• -m pdoc直接调用pdoc的模块入口，和pdoc.exe功能完全一致，支持所有命令行参数，不会有功能缺失

方案2：Python脚本封装（更灵活） #

如果需要自定义参数或扩展逻辑，写个轻量Python脚本（比如命名为start_pdoc.py），再用批处理调用：

import sys
import subprocess

# 获取当前环境的Python解释器路径
python_exe = sys.executable
# 传递所有命令行参数（除脚本自身），完整复用pdoc功能
subprocess.run([python_exe, "-m", "pdoc"] + sys.argv[1:], check=True)

对应的批处理文件：

@echo off
python start_pdoc.py my_package
pause

• 自动适配当前环境的Python，支持传递所有pdoc参数（比如start_pdoc.py my_package --html --output docs）
• 完全复刻pdoc.exe的全部功能，没有局限性

方案3：纯批处理自动查找路径 #

如果不想依赖额外Python脚本，可通过pip定位pdoc的安装路径：

@echo off
for /f "delims=" %%i in ('pip show pdoc ^| findstr /i "Location"') do set "PDOC_LOC=%%i"
set "PDOC_EXE=%PDOC_LOC:~9%\pdoc.exe"
"%PDOC_EXE%" my_package
pause

• 用pip show pdoc获取安装位置，自动拼接出pdoc.exe路径
• 前提是当前环境的pip能识别到pdoc（建议将pdoc设为你的包的依赖项）

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