Env文件语法规范：非字符串配置写法与Python读取差异

1. 两种配置是否等效？ #

完全不等效。环境变量在系统层面本质都是字符串，两种写法的差异很明显：

• 配置1里的EMAIL_PORT=587，最终存储的字符串是'587'；EMAIL_USE_TLS=True存的是'True'；EMAIL_USE_SSL=None存的是'None'。
• 配置2里带单引号的写法，如果是直接设置为系统环境变量，存储的值会包含单引号——比如EMAIL_PORT的值是"'587'"，EMAIL_USE_TLS是"'True'"。只有用python-dotenv这类专门解析.env文件的库时，才会自动去掉引号让两者值一致，但原生os.getenv()不会做这个处理。

2. os.getenv()读取后的实际结果 #

不管哪种配置，os.getenv()返回的都是字符串类型，不会自动转成整数、布尔值或者None：

• EMAIL_PORT：配置1返回字符串'587'，配置2直接读的话返回"'587'"（带单引号），都不是整数587。
• EMAIL_USE_TLS：配置1返回'True'，配置2返回"'True'"，都不是Python的布尔值True。
• EMAIL_USE_SSL：配置1返回'None'，配置2返回"'None'"，都不是Python的None对象。

3. Env文件变量赋值规范 #

• 一般情况下别给值加引号，除非值里有空格、=、#这类特殊字符，这时才需要用单/双引号包裹。
• =前后别加空格，不然空格会被当成值的一部分。
• 别直接写Python语法的True/False/None来表示布尔或空值，建议用统一的字符串标识，比如true/false、yes/no、1/0。

4. 非字符串类型的处理方法 #

读取后得自己手动转类型，或者用现成的库简化：

• 整数转换：用int()强转，记得加默认值和异常处理：

  try:
      EMAIL_PORT = int(os.getenv("EMAIL_PORT", "587"))
  except ValueError:
      EMAIL_PORT = 587
  

• 布尔值转换：写个简单的判断函数：

  def str_to_bool(s):
      return s.strip().lower() in ['true', 'yes', '1']
  
  EMAIL_USE_TLS = str_to_bool(os.getenv("EMAIL_USE_TLS", "false"))
  

• None值处理：判断字符串是否为'None'或者空：

  ssl_env = os.getenv("EMAIL_USE_SSL")
  EMAIL_USE_SSL = None if ssl_env == 'None' else ssl_env
  

• 嫌麻烦的话，用python-decouple这类库，它能自动解析类型：

  from decouple import config
  
  EMAIL_PORT = config("EMAIL_PORT", cast=int, default=587)
  EMAIL_USE_TLS = config("EMAIL_USE_TLS", cast=bool, default=False)
  

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