如何在PowerShell ISE中运行带参数的Python脚本并打包依赖

原来的脚本里四个变量是硬编码的，要改成从外部接收参数，有两种常用方式：

方式1：用sys模块读取位置参数 #

这种方法简单直接，适合参数顺序固定的场景：

1. 在Python脚本开头导入sys模块：import sys
2. 把原来的硬编码变量替换成从sys.argv读取（注意sys.argv[0]是脚本本身路径，参数从索引1开始）：

# 替换原硬编码代码
campaign = sys.argv[1]
dir_xml = sys.argv[2]
dir_pictures = sys.argv[3]
dir_output = sys.argv[4]

3. 可添加参数校验，避免参数缺失报错：

if len(sys.argv) != 5:
    print("请传入4个参数：campaign dir_xml dir_pictures dir_output")
    exit(1)

方式2：用argparse模块读取命名参数 #

这种方法更清晰，参数顺序可随意调整，还能添加注释说明，适合复杂场景：

1. 导入argparse模块：import argparse
2. 创建参数解析器并定义四个必填参数：

parser = argparse.ArgumentParser(description="处理图片与XML的工具脚本")
parser.add_argument("--campaign", required=True, help="活动名称")
parser.add_argument("--dir-xml", required=True, help="XML文件存放目录")
parser.add_argument("--dir-pictures", required=True, help="图片文件存放目录")
parser.add_argument("--dir-output", required=True, help="结果文件输出目录")
args = parser.parse_args()

3. 替换原变量为解析后的参数：

campaign = args.campaign
dir_xml = args.dir_xml
dir_pictures = args.dir_pictures
dir_output = args.dir_output

根据Python脚本的参数类型，对应两种传参方式：

对应位置参数的传参方式 #

1. 在PowerShell脚本里先定义四个变量：

$campaign = "2024夏季促销"
$dir_xml = "C:\project\data\xml"
$dir_pictures = "C:\project\images"
$dir_output = "C:\project\results"

2. 按顺序传入变量调用Python脚本：

python .\your_script.py $campaign $dir_xml $dir_pictures $dir_output

如果路径包含空格，给变量套上引号即可：

$dir_pictures = "C:\My Documents\Pictures"
python .\your_script.py $campaign $dir_xml "$dir_pictures" $dir_output

对应命名参数的传参方式 #

先定义变量，再通过参数名传递：

$campaign = "2024夏季促销"
$dir_xml = "C:\project\data\xml"
$dir_pictures = "C:\project\images"
$dir_output = "C:\project\results"

python .\your_script.py --campaign $campaign --dir-xml $dir_xml --dir-pictures $dir_pictures --dir-output $dir_output

有两种方案，可根据需求选择：

方案1：下载依赖包到本地，供目标电脑离线安装 #

适合目标电脑已有Python，但不想联网安装依赖的场景：

1. 本地创建虚拟环境隔离依赖：

python -m venv .\script_env
.\script_env\Scripts\Activate.ps1

2. 安装脚本所需的所有依赖包（比如lxml、Pillow等）：

pip install lxml pillow

3. 导出依赖清单：

pip freeze > requirements.txt

4. 下载所有依赖包到指定目录：

pip download -r requirements.txt -d .\dependencies

5. 把Python脚本、requirements.txt、dependencies文件夹复制到目标电脑，在目标电脑的PowerShell中运行：

pip install --no-index --find-links=./dependencies -r requirements.txt

安装完成后即可直接运行脚本。

方案2：用PyInstaller打包成独立可执行文件 #

适合目标电脑没有Python，完全无需安装任何环境的场景：

1. 激活本地虚拟环境，安装PyInstaller：

pip install pyinstaller

2. 打包Python脚本为单个exe文件（生成的文件在dist文件夹中）：

pyinstaller --onefile your_script.py

3. 把dist文件夹里的exe文件复制到目标电脑，直接在PowerShell中传参运行：

# 位置参数方式
.\your_script.exe "2024夏季促销" "C:\project\data\xml" "C:\project\images" "C:\project\results"

# 命名参数方式
.\your_script.exe --campaign "2024夏季促销" --dir-xml "C:\project\data\xml" --dir-pictures "C:\project\images" --dir-output "C:\project\results"

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