Python部署环境的核心是确保代码稳定运行，关键在于匹配项目依赖的Python版本（如3.8–3.11）、使用pyenv管理多版本、虚拟环境隔离依赖、配置系统权限与端口、抽离敏感配置至环境变量或.env文件。
Python部署环境的核心是确保代码能在目标机器上稳定运行，关键不在装最新版Python，而在于匹配项目依赖、系统权限和运行时约束。
Python版本与项目兼容性
很多项目明确要求Python 3.8–3.11之间的某个小版本，比如Django 4.2不支持Python 3.12，Flask 2.2要求≥3.8。直接用系统自带的Python（如CentOS 7默认的3.6）很可能报ModuleNotFoundError或语法错误。
- 查看项目根目录下的pyproject.toml或requirements.txt，找python = ">=3.9"这类声明
- 用python --version确认当前版本，不匹配时推荐用pyenv管理多版本，避免污染系统环境
- 虚拟环境中也要用对应版本创建：pyenv install 3.10.12 && pyenv local 3.10.12
依赖包安装与隔离机制
生产环境严禁用pip install -r requirements.txt全局安装——不同项目可能依赖同一包的不同版本，互相冲突。
- 必须使用虚拟环境：python -m venv venv && source venv/bin/activate（Linux/macOS）或venv\Scripts\activate（Windows）
- 安装前先升级pip：pip install --upgrade pip，避免因旧版pip解析依赖出错
- 若依赖中含C扩展（如psycopg2、numpy），需提前装好系统级编译工具和库（如build-essential、libpq-dev）
系统级运行支撑条件
Python本身能跑，不代表服务能对外提供。Web应用要监听端口、读写文件、连接数据库，这些都受操作系统限制。
立即学习“Python免费学习笔记（深入）”；
- 非root用户无法绑定1024以下端口（如80、443），部署时改用高号端口（如8000），再用Nginx反向代理
- 确保运行用户对代码目录、日志路径、上传文件夹有读写权限，常见错误是PermissionError: [Errno 13] Permission denied
- 数据库驱动需匹配服务端版本，例如MySQL 8.0+默认用caching_sha2_password认证插件，旧版PyMySQL可能连不上，应换用mysqlclient或更新配置
运行时配置与环境变量
硬编码密钥、数据库地址、调试开关，在部署时必须抽离。靠代码里写if os.getenv("ENV") == "prod"判断不够健壮。
- 用python-decouple或dynaconf加载.env文件，敏感信息绝不进Git
- 区分DEBUG=False、SECRET_KEY、ALLOWED_HOSTS等Django关键项，或Flask的FLASK_ENV=production
- 容器化部署时，通过docker run -e DATABASE_URL=...注入变量，比挂载配置文件更灵活安全
