最常见原因是 root logger 的 StreamHandler 被移除或其级别设为 WARNING 以上，导致 INFO 日志被过滤；需检查 handlers 是否为空、各级别设置，并补全 StreamHandler 与 root 级别。
为什么 logging.info() 调用后控制台完全没输出？
最常见原因是默认的 root logger 虽然存在，但它的 StreamHandler 被显式移除了，或者该 handler 的级别被设得太高（比如设成 WARNING），而你发的是 INFO 级日志。
Python 的 logging 模块启动时会自动为 root logger 添加一个 StreamHandler（输出到 stderr），但只要代码里调过 logging.getLogger().handlers.clear()、logging.basicConfig() 且传了 handlers=...、或手动 logger.removeHandler(...)，就可能把它干掉。
- 检查是否在项目启动处调用了
logging.basicConfig()并传了空handlers=[]或自定义 handler 列表但漏了StreamHandler - 搜索代码中是否有
.removeHandler或.handlers.clear()—— 特别注意第三方库初始化时也可能偷偷干这事 - 运行时打印
logging.getLogger().handlers，看长度是否为 0；若不为 0，逐个查h.level和h.stream
如何快速恢复控制台输出？
不是重写整个 logging 配置，而是最小干预：给 root logger 补一个最低限度可用的 StreamHandler。
关键点是 handler 自身要有合理级别，且 root logger 本身级别不能卡死（默认是 WARNING，必须显式设成 INFO 或更低）。
- 执行
logging.getLogger().setLevel(logging.DEBUG)—— 先放开 root logger 接收门槛 - 执行
logging.getLogger().addHandler(logging.StreamHandler())—— 补一个默认输出到 stderr 的 handler - 如果想输出到 stdout（而不是 stderr），显式传
stream=sys.stdout：logging.StreamHandler(sys.stdout) - 补完后立刻试
logging.info("test")，有输出说明生效
basicConfig() 不生效？可能是调用时机或参数冲突
logging.basicConfig() 只在 root logger 尚未添加任何 handler 时才生效。一旦 handler 已存在（哪怕只有 1 个），它就直接 return，什么也不做。
创建 Flask + Vue.js 全栈项目，采用单端口架构、uv 依赖管理、结构化日志和生产级前端设计。当用户要求以下操作时触发：创建新的 Flask+Vue 项目、搭建 Web 应用、构建全栈 Python+Vue 应用、初始化 Flask Web 项目、设置单端口 Flask 前后端项目。触发词：新建项目、创建项目、搭建项目、Flask项目、Vue项目。
所以常见陷阱是：你在 import logging 后立刻调 basicConfig()，但某个早于它的模块（比如某些框架、配置加载器）已经触发了 logging，悄悄创建了 handler。
- 把
basicConfig()放到真正首次打日志前的**第一行可执行语句**，比如if __name__ == "__main__":开头 - 避免混用
basicConfig()和手动 handler 操作；二者选一，否则极易互相覆盖 - 如果一定要用
basicConfig()，加force=True参数（Python 3.8+）可强制重置，但会清掉已有 handlers —— 注意这会影响其他模块已注册的 handler
为什么加了 StreamHandler 还是没输出？查 stream 和 encoding
handler 创建了，级别也对，但控制台仍静音？问题可能出在底层流对象本身 —— 比如 stream 被关闭、重定向到文件、或终端编码不匹配导致 write 失败（尤其 Windows + 中文路径/内容）。
典型现象：日志在 IDE 控制台不显示，但在系统终端（cmd / PowerShell / Terminal）里正常；或只在某些环境出问题。
- 检查
handler.stream是否为sys.stderr或sys.stdout；如果是文件对象，确认路径可写且没被锁 - Windows 下若终端是旧版 cmd，遇到 Unicode 字符（如中文）可能静默失败；可临时加
encoding="utf-8"到StreamHandler构造参数中 - 某些容器或 CI 环境会把
sys.stderr重定向为/dev/null，此时即使 handler 存在也无输出 —— 用print(repr(sys.stderr))快速验证
事情说清了就结束
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
