Python 的 `logging` 模块提供了丰富的格式化选项，用于定义日志消息的输出格式。格式化主要通过 `format` 参数来指定，通常在调用 `logging.basicConfig()` 方法时进行设置。以下是一些常用的格式配置选项： - **%(asctime)s**：用于在日志中包含时间戳，表示日志消息被创建的时间。时间戳的格式可以通过 `datefmt` 参数进一步定制。 - **%(levelname)s**：显示日志级别名称，例如 DEBUG、INFO、WARNING、ERROR、CRITICAL。 - **%(message)s**：这是日志消息的主体内容，由用户提供的字符串组成。 - **%(name)s**：表示日志记录器的名称，这对于识别日志来源非常有用。 - **%(filename)s**：显示生成日志消息的文件名。 - **%(lineno)d**：显示生成日志消息的代码行号，有助于快速定位问题。 - **%(funcName)s**：显示生成日志消息的函数名，有助于理解日志上下文。 - **%(thread)d** 和 **%(threadName)s**：分别显示线程ID和线程名称，对于多线程应用的日志分析非常有用。 - **%(process)d**：显示进程ID，适用于多进程应用程序。 - **%(pathname)s**：显示当前执行程序的完整路径，这在大型项目中特别有用，可以帮助确定日志的具体来源文件[^3]。 一个具体的例子如下，演示了如何设置一个包含时间、日志级别和消息的格式： ```python import logging LOG_FORMAT = "时间：%(asctime)s - 日志等级：%(levelname)s - 日志信息：%(message)s" logging.basicConfig(level=logging.WARNING, format=LOG_FORMAT) logging.debug("This is a debug log") logging.info("This is a info log") logging.warning("This is a warning log") logging.error("This is a error log") logging.critical("This is a critical log") ``` 在这个例子中，日志级别被设置为 `WARNING`，这意味着只有级别为 `WARNING` 及以上（即 `ERROR` 和 `CRITICAL`）的日志消息会被记录。通过这种方式，可以灵活地控制日志输出的详细程度[^2]。 此外，还可以通过 `datefmt` 参数自定义时间戳的格式，例如： ```python logging.basicConfig( level=logging.DEBUG, format='%(asctime)s - %(name)s - %(levelname)s - %(message)s', datefmt='%Y-%m-%d %H:%M:%S' ) ``` 这里的时间戳格式 `%Y-%m-%d %H:%M:%S` 表示四位数的年份、两位数的月份、两位数的日期，接着是小时、分钟和秒，这样的格式通常易于阅读且信息量充足[^1]。 通过这些配置，开发者可以根据自己的需求定制日志输出格式，以便更好地满足调试、监控和审计的需求。