Azure WebApp部署Django：如何用Pipfile.lock替代requirements.txt

Azure默认仅支持通过requirements.txt或setup.py处理依赖，要改用Pipfile.lock，可以通过自定义setup.py的安装逻辑来实现，具体步骤如下：

1. 编写自定义setup.py文件 #

在项目根目录创建setup.py，通过自定义安装命令调用pipenv从Pipfile.lock安装依赖：

from setuptools import setup
from setuptools.command.install import install
import subprocess

class CustomInstall(install):
    def run(self):
        # 先安装pipenv（确保环境具备该工具）
        subprocess.run(["pip", "install", "pipenv"], check=True)
        # 从Pipfile.lock安装依赖到系统环境（--system跳过虚拟环境，适配Azure部署）
        subprocess.run(["pipenv", "install", "--deploy", "--system"], check=True)
        # 执行默认的安装流程
        install.run(self)

setup(
    name="your-django-project-name",
    version="1.0.0",
    cmdclass={"install": CustomInstall},
    install_requires=[],  # 依赖由pipenv处理，此处留空
)

2. 调整项目文件 #

• 删除或重命名项目中的requirements.txt（如果存在），确保Azure优先识别setup.py。
• 确保Pipfile和Pipfile.lock都在项目根目录，且Pipfile.lock是基于Azure使用的Python版本生成的（避免版本兼容问题）。

3. 触发Azure部署 #

将代码推送到Azure关联的代码仓库（如GitHub、Azure Repos），Azure会自动执行python setup.py install，触发自定义安装流程：

• 先安装pipenv工具
• 通过--deploy参数严格按照Pipfile.lock的依赖版本安装到系统Python环境（--system参数适配Azure的部署环境，无需虚拟环境）

关键注意事项 #

• --deploy参数会校验Pipfile与Pipfile.lock的一致性，若两者不匹配会直接报错，避免依赖版本混乱。
• 如果确认Azure部署环境已预装pipenv，可以移除subprocess.run(["pip", "install", "pipenv"], check=True)这一行，提升部署效率。

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