将JSON字符串作为参数传入Pytest时遇zsh事件未找到错误

核心原因 #

zsh对反斜杠、!这类特殊字符的解析规则比bash更严格，直接在命令行传递JSON字符串时，内部的转义字符会被zsh当作**历史扩展（history expansion）**触发，从而抛出event not found: \错误。你之前尝试用\"替换双引号的方式无效，因为"是HTML实体，shell无法识别。

可行解决方案 #

1. 用单引号包裹整个JSON字符串 #

zsh中，单引号内的所有字符会被当作纯文本处理，不会触发任何转义或扩展逻辑，这是最直接的解决方式：

pytest --vm-name test-vm --vm-ip 192.168.1.100 --credentials '{"username":"admin","password":"123456"}'

如果JSON本身包含单引号，需把内部单引号转义为'\''（格式：单引号+转义单引号+单引号），例如：

pytest --credentials '{"name":"user'\''s account","password":"123456"}'

2. 临时关闭zsh的历史扩展功能 #

执行命令前先关闭当前会话的历史扩展，再传递转义后的JSON：

set +o histexpand
pytest --vm-name test-vm --vm-ip 192.168.1.100 --credentials "{\"username\":\"admin\",\"password\":\"123456\"}"

若需要永久关闭，可将set +o histexpand添加到~/.zshrc文件中。

3. 通过环境变量传递JSON #

把JSON内容存入环境变量，避免命令行直接传递的转义问题：

• 先设置环境变量：

export TEST_CREDENTIALS='{"username":"admin","password":"123456"}'

• 修改conftest.py，支持从环境变量读取credentials：

import os
import json
from dataclasses import dataclass

@dataclass
class Credentials:
    username: str
    password: str

def load_credentials(json_str=None):
    if not json_str:
        json_str = os.getenv("TEST_CREDENTIALS")
    data = json.loads(json_str)
    return Credentials(**data)

• 执行Pytest时无需传递--credentials参数：

pytest --vm-name test-vm --vm-ip 192.168.1.100

4. 使用文件传递JSON #

将JSON内容写入单独文件，让--credentials参数接受文件路径而非字符串：

• 创建credentials.json文件：

{"username":"admin","password":"123456"}

• 修改conftest.py的load_credentials函数：

import os
import json
from dataclasses import dataclass

@dataclass
class Credentials:
    username: str
    password: str

def load_credentials(credential_source):
    if os.path.exists(credential_source):
        with open(credential_source, 'r') as f:
            json_str = f.read()
    else:
        json_str = credential_source
    data = json.loads(json_str)
    return Credentials(**data)

• 执行命令时传递文件路径：

pytest --vm-name test-vm --vm-ip 192.168.1.100 --credentials ./credentials.json

验证建议 #

优先尝试第一种方案（单引号包裹），无需修改代码即可快速解决问题。如果JSON包含单引号或复杂特殊字符，再考虑环境变量或文件传递的方式。

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