def 查询_字段值列表(连接对象, 表名, 字段名):
    """
    查询指定表中某字段的全部值，并以列表形式返回。（老版本，于2025年11月26日正式退役，后续建议使用 查询_字段全部值 代替）

    参数：
        - 连接对象：与数据库的连接对象。
        - 表名：要查询的表名。
        - 字段名：要查询的字段名。

    返回值：
        - 字段值列表：包含所有值的列表，如果查询失败则返回 None。

    使用示例（可以复制并直接修改）：
        字段值列表 = zfx_mysql.查询_字段值列表(连接对象, "users", "name")

        # 替换参数：
        # - 连接对象：已建立的数据库连接对象
        # - 表名：要查询的表名称，如 "users" 或 "orders"
        # - 字段名：要查询的字段名称，如 "name" 或 "age"

        # 使用查询返回的字段值列表：
        # if 字段值列表 is not None:
        #     print("字段值列表:", 字段值列表)
        # else:
        #     print("查询失败")
    """
    游标对象 = None
    try:
        游标对象 = 连接对象.cursor()
        游标对象.execute(f"SELECT {字段名} FROM {表名}")
        字段值列表 = [row[0] for row in 游标对象.fetchall()]
        return 字段值列表
    except Exception:
        return None
    finally:
        if 游标对象:
            游标对象.close()