Windows系统下如何解决Pipenv scripts中环境变量无法解析的问题

问题根源 #

你使用的$env:PYPI_CREDS是PowerShell专属的环境变量读取语法，而Windows环境下Pipenv执行scripts默认调用CMD shell，CMD无法识别该语法，因此变量无法被正确替换。Pipenv已经正常加载了.env中的PYPI_CREDS到进程环境变量中，仅需调整写法即可正常读取。 #

解决方法 #

• 方法1：改用CMD兼容的变量语法（最简便）
  直接将Pipfile中scripts的变量写法替换为CMD识别的%变量名%格式：

  [scripts]
  docker_build = "docker build --build-arg PYPI_CREDS=%PYPI_CREDS% -t myimage:latest ."
  

  修改后直接执行pipenv run docker_build就能正常传入变量。

  注意：如果你的PYPI_CREDS包含空格、&、*等特殊字符，需要给参数部分加转义引号，写法调整为：

  docker_build = "docker build --build-arg \"PYPI_CREDS=%PYPI_CREDS%\" -t myimage:latest ."
  

• 方法2：保留PowerShell语法的方案
  如果你需要使用PowerShell的语法规则，可以指定Pipenv用PowerShell执行脚本：

  1. 临时生效：执行脚本前先在终端运行set PIPENV_SHELL=powershell
  2. 永久生效：给系统添加环境变量PIPENV_SHELL，值设为powershell
     配置完成后原有的$env:PYPI_CREDS写法即可正常生效。

• 方法3：跨平台兼容写法
  如果需要同时兼顾Windows、Linux/macOS环境，可以用Python中转读取环境变量，规避不同shell的语法差异：

  [scripts]
  docker_build = "python -c \"import os, subprocess; subprocess.run(['docker', 'build', '--build-arg', f'PYPI_CREDS={os.getenv('PYPI_CREDS')}', '-t', 'myimage:latest', '.'], check=True)\""
  

验证方法 #

你可以先添加一个测试脚本确认变量可以正常读取：

[scripts]
test_env = "echo %PYPI_CREDS%"

执行pipenv run test_env，如果输出了你在.env中定义的PYPI_CREDS值，就说明配置生效。 #

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