Python 3.15 beta 2 发布：该动手验证了

# 用 pyenv 安装 Python 3.15.0b2（需要先更新 pyenv 的定义）
pyenv update
pyenv install 3.15.0b2

# 设置为某个项目的本地版本
cd ~/my-project
pyenv local 3.15.0b2

# 确认版本
python --version
# 应输出: Python 3.15.0b2

conda create -n py315b2 python=3.15.0b2 -c conda-forge
conda activate py315b2

# 安装项目依赖（可能需要处理兼容问题）
pip install -e ".[dev]"

# 跑完整测试
pytest --tb=short -q

# 如果有 C 扩展，尝试 free-threaded 构建
# 需要单独安装 free-threaded 版本的 Python 3.15
# 然后重新编译你的 C 扩展并测试

"""quick_compat_check.py — 扫描项目源码中的潜在兼容问题"""
import ast
import sys
from pathlib import Path

# 3.15 中可能移除或变更的 API（根据各版本 deprecated 路径整理）
# 这里列出一些常见的，实际列表需参考官方 "What's New"
FLAGGED_IMPORTS = {
    # 示例：某些旧模块在后续版本移除
    # "asyncore": "3.12 已 deprecated，后续版本移除",
    # "imp": "3.4 已 deprecated，使用 importlib",
}

FLAGGED_ATTRS = {
    # 示例属性访问
    # ("sys", "setrecursionlimit"): "注意 free-threaded 下行为可能不同",
}

def scan_file(filepath: Path) -> list[str]:
    """解析单个 Python 文件，返回发现的警告列表"""
    warnings = []
    try:
        tree = ast.parse(filepath.read_text(encoding="utf-8"))
    except SyntaxError:
        return warnings

    for node in ast.walk(tree):
        if isinstance(node, ast.Import):
            for alias in node.names:
                if alias.name in FLAGGED_IMPORTS:
                    warnings.append(
                        f"{filepath}:{node.lineno} — "
                        f"import {alias.name}: {FLAGGED_IMPORTS[alias.name]}"
                    )
        elif isinstance(node, ast.ImportFrom):
            if node.module in FLAGGED_IMPORTS:
                warnings.append(
                    f"{filepath}:{node.lineno} — "
                    f"from {node.module}: {FLAGGED_IMPORTS[node.module]}"
                )
            for alias in node.names:
                key = (node.module or "", alias.name)
                if key in FLAGGED_ATTRS:
                    warnings.append(
                        f"{filepath}:{node.lineno} — "
                        f"{node.module}.{alias.name}: {FLAGGED_ATTRS[key]}"
                    )
    return warnings

def main():
    src_dir = Path(sys.argv[1] if len(sys.argv) > 1 else ".")
    all_warnings = []
    for py_file in src_dir.rglob("*.py"):
        all_warnings.extend(scan_file(py_file))

    if all_warnings:
        print(f"⚠ 发现 {len(all_warnings)} 个潜在兼容问题：")
        for w in all_warnings:
            print(w)
    else:
        print("✅ 未扫描到已知废弃 API 的使用")

if __name__ == "__main__":
    main()

python quick_compat_check.py ./src