VSCode任务参数中转义分号遇阻，PyInstaller配置求助

问题描述 #

Windows系统下，PyInstaller的--add-data参数要求用分号;分隔源路径与目标路径，但在VSCode的任务配置中，无法正确转义该分号，尝试多种value/quoting格式均无效，导致任务执行不符合预期。

原任务配置 #

"version": "2.0.0",
"tasks": [
    {
        "label": "Run Pyinstaller",
        "type": "shell",
        "command": "powershell",
        "args": [
            "pyinstaller",
            "--onefile",
            "--noconsole",
            "--name=my_app",
            "--icon=release/shrt_icon.ico",
            "--log-level=WARN",
            "--add-data",
            {
                "value": "release/my_data.dat;.",
                "quoting": "weak"
            },
            "cli.py"
        ],
        "group": {
            "kind": "build",
            "isDefault": true
        },
        "problemMatcher": [
            "$gcc"
        ]
    }
]

期望执行的命令 #

pyinstaller --onefile --noconsole --name=my_app --icon=release/shrt_icon.ico --log-level=WARN --add-data "release/my_data.dat;." cli.py

解决办法 #

方法一：通过-Command传递完整命令字符串 #

将整个PyInstaller命令作为PowerShell的-Command参数传递，让PowerShell完整解析命令，避免分号被当作命令分隔符：

"version": "2.0.0",
"tasks": [
    {
        "label": "Run Pyinstaller",
        "type": "shell",
        "command": "powershell",
        "args": [
            "-Command",
            "pyinstaller --onefile --noconsole --name=my_app --icon=release/shrt_icon.ico --log-level=WARN --add-data \"release/my_data.dat;.\" cli.py"
        ],
        "group": {
            "kind": "build",
            "isDefault": true
        },
        "problemMatcher": [
            "$gcc"
        ]
    }
]

方法二：合并--add-data与参数并使用强引用 #

将--add-data和带分号的参数合并为一个配置项，设置quoting为strong，让VSCode为整个参数添加完整引号：

"version": "2.0.0",
"tasks": [
    {
        "label": "Run Pyinstaller",
        "type": "shell",
        "command": "powershell",
        "args": [
            "pyinstaller",
            "--onefile",
            "--noconsole",
            "--name=my_app",
            "--icon=release/shrt_icon.ico",
            "--log-level=WARN",
            {
                "value": "--add-data release/my_data.dat;.",
                "quoting": "strong"
            },
            "cli.py"
        ],
        "group": {
            "kind": "build",
            "isDefault": true
        },
        "problemMatcher": [
            "$gcc"
        ]
    }
]

原因说明 #

在PowerShell中，分号;是命令分隔符，默认会将其前后内容识别为两个独立命令。上述两种方式要么让PowerShell解析完整命令字符串，要么让VSCode为包含分号的参数添加完整引号，从而避免分号被错误解析。

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