如何让VS Code的Python .env文件兼容Windows与Linux系统

核心方案：利用VS Code系统特定配置直接设置终端PYTHONPATH #

既然你已经在settings.json中配置终端集成环境变量，直接针对Windows和Linux分别定义带对应分隔符的PYTHONPATH即可，彻底摆脱手动修改.env的麻烦：

1. 打开工作区的settings.json（通过Ctrl+,打开设置，点击右上角的打开设置(JSON)）
2. 添加以下系统针对性配置：

{
  // Windows系统终端环境变量配置
  "[windows]": {
    "terminal.integrated.env.windows": {
      "PYTHONPATH": "${workspaceFolder};${workspaceFolder}/src;${workspaceFolder}/utils"
    }
  },
  // Linux系统终端环境变量配置
  "[linux]": {
    "terminal.integrated.env.linux": {
      "PYTHONPATH": "${workspaceFolder}:${workspaceFolder}/src:${workspaceFolder}/utils"
    }
  }
}

• 把${workspaceFolder}/src、${workspaceFolder}/utils替换成你实际需要添加的子路径
• VS Code会根据当前自动识别的系统，加载对应区块的终端环境变量，无需手动切换

调试器PYTHONPATH适配（针对python.envFile仅用于调试的情况） #

如果调试器需要相同的PYTHONPATH，无需修改.env，可以直接在launch.json中做系统针对性配置：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Python: Current File",
      "type": "python",
      "request": "launch",
      "program": "${file}",
      "console": "integratedTerminal",
      // Windows调试器PYTHONPATH
      "windows": {
        "env": {
          "PYTHONPATH": "${workspaceFolder};${workspaceFolder}/src;${workspaceFolder}/utils"
        }
      },
      // Linux调试器PYTHONPATH
      "linux": {
        "env": {
          "PYTHONPATH": "${workspaceFolder}:${workspaceFolder}/src:${workspaceFolder}/utils"
        }
      }
    }
  ]
}

备选方案：脚本内自动处理.env中的路径分隔符 #

如果坚持要保留.env文件存储路径，可以在项目入口脚本开头添加一段代码，自动兼容两种分隔符：

import os
import sys

# 读取.env文件中的PYTHONPATH配置
env_file = os.path.join(os.path.dirname(os.path.abspath(__file__)), '.env')
if os.path.exists(env_file):
    with open(env_file, 'r', encoding='utf-8') as f:
        for line in f:
            line = line.strip()
            if line.startswith('PYTHONPATH='):
                # 统一将分号替换为冒号，再拆分路径
                raw_paths = line.split('=')[1].replace(';', ':').split(':')
                # 转换为绝对路径并添加到sys.path
                for path in raw_paths:
                    abs_path = os.path.abspath(path.strip())
                    if abs_path not in sys.path:
                        sys.path.append(abs_path)
                break

• 此方法无需修改.env中的分隔符（可以统一用冒号或分号），脚本会自动处理为系统适配的格式
• 缺点是需要在所有入口脚本中添加这段代码

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