实现区分Windows与Linux环境的Python脚本，是否有更规范的最佳实践？

这是个非常常见的跨环境开发痛点——我之前维护跨平台项目时也踩过直接写sys.platform判断的坑，分享几个更健壮、易维护的替代方案：

1. 用环境变量定义环境状态（最灵活） #

与其依赖系统平台判断，不如直接用环境变量明确标记当前是「开发」还是「生产」环境。这样不管你在Windows开发、Linux开发还是Linux生产，都能灵活切换逻辑，不受系统限制。

示例代码：

import os

# 读取环境变量，默认设为开发环境
current_env = os.getenv("APP_ENV", "development")

if current_env == "production":
    # Linux生产环境专属逻辑：比如调用系统级工具、加载生产配置
    setup_production_resources()
else:
    # Windows开发环境逻辑：比如用本地模拟服务、开启调试模式
    setup_development_tools()

使用时，只需要在生产服务器上设置环境变量（比如在启动脚本里加export APP_ENV=production），本地Windows环境默认用开发模式即可。

2. 分离配置文件（适合中大型项目） #

把不同环境的配置和逻辑开关单独放在配置文件里，代码只负责读取配置，彻底实现「配置与代码分离」。比如用YAML格式的配置文件：

生产环境配置（config_prod.yaml） #

environment: production
enable_linux_features: true
api_endpoint: "https://prod.example.com/api"

开发环境配置（config_dev.yaml） #

environment: development
enable_linux_features: false
api_endpoint: "http://localhost:8000/api"

然后在代码中加载对应配置：

import os
import yaml

def load_app_config():
    env = os.getenv("APP_ENV", "development")
    with open(f"config_{env}.yaml", "r", encoding="utf-8") as f:
        return yaml.safe_load(f)

config = load_app_config()

if config["enable_linux_features"]:
    run_linux_specific_code()
else:
    run_development_alternative()

这种方式的好处是，所有环境相关的设置都集中在配置文件里，多人协作时不会不小心改到业务代码，后期新增测试环境也只需要加个配置文件就行。

3. 使用专业配置管理库（类型安全+规范） #

如果项目规模较大，推荐用pydantic-settings这类专门的配置管理库，它能自动从环境变量、.env文件加载配置，还支持类型校验，避免配置错误。

首先安装依赖：

pip install pydantic-settings

然后定义配置类：

from pydantic_settings import BaseSettings

class AppSettings(BaseSettings):
    # 配置默认值，可被环境变量覆盖
    environment: str = "development"
    use_linux_specific_libs: bool = False

    # 指定加载.env文件
    class Config:
        env_file = ".env"
        env_file_encoding = "utf-8"

settings = AppSettings()

# 根据配置分支逻辑
if settings.environment == "production":
    initialize_production_env()
else:
    initialize_development_env()

在生产服务器的.env文件里只需写：

ENVIRONMENT=production
USE_LINUX_SPECIFIC_LIBS=true

本地Windows的.env保持默认配置即可。这种方案不仅规范，还能自动处理配置类型转换，减少调试成本。

4. 封装系统判断工具函数（兼容现有逻辑） #

如果你还是需要基于系统平台判断，别在代码里到处写if sys.platform == "linux"，而是把判断逻辑封装成工具函数，统一维护：

import sys
import os

def is_production() -> bool:
    # 双重校验：既判断系统平台，又验证环境变量，避免误判
    return sys.platform.startswith("linux") and os.getenv("APP_ENV") == "production"

def is_development() -> bool:
    return sys.platform.startswith("win32") or os.getenv("APP_ENV") == "development"

# 业务代码中调用
if is_production():
    run_production_task()

这样以后如果新增Mac开发环境，或者修改生产环境的判断条件，只需要更新工具函数，不用改所有业务代码，容错性大大提升。

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