viable/strict/1787722055: Fix the version gate on the free-threaded profiler warning (#194697)
PyTorch 修复了自由线程分析器警告的版本门控问题。IS_PYTHON_3_14_PLUS 宏始终被定义，导致 !defined(IS_PYTHON_3_14_PLUS) 永远为假，警告在 3.13t 上从未触发。修复改用宏的布尔值。PR #194697 已合并。
发展脉络
- 首次出现viable/strict/1787722055: Fix the version gate on the free-threaded profiler warning (#194697)PyTorch Core
- 行业反馈trunk/fcebff2edcedc4a973b6124659b9b7932db725ad: Fix the version gate on the free-threaded profiler warning (#194697)PyTorch Core
- 当前判断PyTorch 对自由线程 Python 的支持仍在完善中，此类修复表明其正在积极解决兼容性问题。自由线程模式是 Python 生态的重要方向，PyTorch 的修复有助于提升其在多线程环境下的性能与稳定性。Agent Pulse · 分析
PyTorch 在 PR #194697 中修复了一个版本门控 bug，该 bug 导致自由线程分析器警告在 Python 3.13t 上从未触发。问题源于 IS_PYTHON_3_14_PLUS 宏始终被定义（因为 PY_VERSION_HEX >= 0x030E0000），所以 !defined(IS_PYTHON_3_14_PLUS) 永远为假。该宏在 #178551 中引入，本意是检查宏的布尔值而非是否定义。修复改为使用宏的值。测试计划包括编译一个针对自由线程 3.14 头文件的探针，确认旧形式在所有版本上不可达，新形式仅在固定到 3.13 PY_VERSION_HEX 时可达。PR 已合并。
此修复表明在条件编译中，检查宏是否定义与检查宏的布尔值有本质区别。IS_PYTHON_3_14_PLUS 始终定义，导致 !defined 检查失效。正确做法是使用宏的值（如 #if IS_PYTHON_3_14_PLUS）。这提醒开发者注意宏定义语义，避免类似逻辑错误。
PyTorch 对自由线程 Python 的支持仍在完善中，此类修复表明其正在积极解决兼容性问题。自由线程模式是 Python 生态的重要方向，PyTorch 的修复有助于提升其在多线程环境下的性能与稳定性。
此修复虽小，但提升了 PyTorch 在自由线程 Python 下的可靠性，对依赖 PyTorch 进行多线程计算的用户有积极影响。它减少了潜在的性能分析误导，有助于开发者正确优化代码。
未来可关注 PyTorch 对 Python 3.14 自由线程的进一步支持，以及相关警告和功能是否按预期工作。可验证信号：后续版本中自由线程分析器警告在 3.13t 上正确触发。