在 Python 中查询成员变量，核心方法包括使用 **内置函数 `dir()`、`vars()`、`getattr()`、`hasattr()` 以及对象的 `__dict__` 属性**，同时结合 `inspect` 模块可以进行更深入的反射分析。对于类成员变量和实例成员变量，需要区分“类属性”与“实例属性”的存储位置与访问方式。**理解 Python 的对象模型与命名空间机制，是准确查询成员变量的关键。**下面将系统讲解不同场景下的实现方式、原理差异与实战示例。

---

## 一、理解成员变量：类属性与实例属性的区别

在讲解 Python 查询成员变量之前，首先必须明确“成员变量”在 Python 语境下通常分为两类：**类成员变量（Class Attribute）与实例成员变量（Instance Attribute）**。类成员变量定义在类体中，归类所有实例共享；实例成员变量通常在 `__init__` 方法中通过 `self.xxx` 方式定义，属于具体对象。

例如：

```python
class User:
    role = "guest"   # 类成员变量
    
    def __init__(self, name):
        self.name = name  # 实例成员变量
```

在这个示例中，`role` 是类属性，而 `name` 是实例属性。查询成员变量时，如果不区分类型，容易误判变量来源。**Python 的属性查找机制遵循 MRO（Method Resolution Order）规则，优先查找实例，再查找类，再查找父类。**

根据 Python 官方文档（Python Software Foundation, 2023），对象属性存储于对象命名空间中，通常通过 `__dict__` 属性访问。这一机制构成了查询成员变量的技术基础。

---

## 二、使用 dir() 查询成员变量

`dir()` 是 Python 查询成员变量最常用的内置函数之一。它返回对象的属性和方法名称列表，包括实例变量、类变量以及继承属性。

示例：

```python
u = User("Alice")
print(dir(u))
```

输出结果会包含：

- `name`
- `role`
- 内置方法如 `__init__`
- 继承自 object 的属性

**优势**：简单直接，适合调试和快速检查对象结构。  
**缺点**：返回内容过多，无法区分变量与方法。

| 方法 | 是否区分变量/方法 | 是否包含继承 | 使用场景 |
|------|------------------|--------------|----------|
| dir() | 否 | 是 | 快速调试 |
| __dict__ | 是 | 否 | 精确查询 |
| vars() | 是 | 否 | 动态获取 |

`dir()` 更适合用于探索式开发，而非精确成员变量统计。

---

## 三、使用 __dict__ 精确获取成员变量

如果希望仅获取实例成员变量，推荐使用对象的 `__dict__` 属性。该属性返回一个字典，包含对象的属性名与对应值。

示例：

```python
print(u.__dict__)
```

输出：

```python
{'name': 'Alice'}
```

**`__dict__` 只包含实例属性，不包含类属性。**

若要获取类属性：

```python
print(User.__dict__)
```

这里会看到 `role`、`__init__` 等定义在类中的内容。

根据《Fluent Python》（Luciano Ramalho, 2nd Edition, 2022）对 Python 对象模型的解释，**对象属性查找优先访问实例的 `__dict__`，若不存在则访问类的 `__dict__`，再查找父类。**

这一机制说明：

- 查询实例成员变量 → 使用 `obj.__dict__`
- 查询类成员变量 → 使用 `Class.__dict__`

---

## 四、使用 vars() 动态查询成员变量

`vars()` 本质上调用对象的 `__dict__` 方法，是更安全的方式。

示例：

```python
print(vars(u))
```

与 `u.__dict__` 输出一致。

优点包括：

- 代码更简洁
- 避免直接访问魔术属性
- 更符合 Pythonic 风格

在函数内部，如果不知道对象是否具有 `__dict__`，可使用：

```python
if hasattr(obj, '__dict__'):
    print(vars(obj))
```

在框架开发或通用库开发中，`vars()` 是更推荐的成员变量查询方式。

---

## 五、使用 getattr() 与 hasattr() 判断成员变量

如果目标是“判断某成员变量是否存在”，推荐使用：

```python
hasattr(u, 'name')
```

如果需要获取变量值：

```python
value = getattr(u, 'name', None)
```

`getattr()` 的第三个参数是默认值，避免属性不存在时报错。

| 函数 | 用途 | 是否安全 | 是否推荐 |
|------|------|----------|----------|
| hasattr() | 判断是否存在 | 是 | ✅ |
| getattr() | 获取属性值 | 是 | ✅ |
| obj.xxx | 直接访问 | 否 | ⚠️ |

在动态系统（如插件系统、配置系统）中，**getattr 是最常见的成员变量访问方式之一**。

---

## 六、使用 inspect 模块深度分析成员变量

当涉及框架开发、ORM 系统、自动序列化等场景时，推荐使用 `inspect` 模块。

示例：

```python
import inspect

members = inspect.getmembers(u)
```

可以结合过滤条件：

```python
inspect.getmembers(u, lambda a: not(inspect.isroutine(a)))
```

这将过滤掉方法，只保留变量。

`inspect` 是 Python 官方推荐的反射工具（Python Docs, inspect module, 2023），适用于：

- 元编程
- 自动生成文档
- 序列化系统
- ORM 映射系统

---

## 七、不同查询方式对比分析

下面从功能与应用角度对比 Python 查询成员变量的方式：

| 方法 | 获取实例变量 | 获取类变量 | 过滤方法 | 适合生产环境 |
|------|--------------|------------|-----------|--------------|
| dir() | ✅ | ✅ | ❌ | ❌ |
| __dict__ | ✅ | ✅（类） | ✅ | ✅ |
| vars() | ✅ | ✅（类） | ✅ | ✅ |
| getattr() | 单个 | 单个 | ✅ | ✅ |
| inspect | ✅ | ✅ | ✅ | ✅ |

综合来看：

- 日常调试 → `dir()`
- 精确获取实例变量 → `vars()` 或 `__dict__`
- 判断存在 → `hasattr()`
- 动态访问 → `getattr()`
- 框架开发 → `inspect`

---

## 八、特殊情况：__slots__ 对成员变量查询的影响

当类定义了 `__slots__` 时，实例将不会生成 `__dict__`，从而影响成员变量查询。

示例：

```python
class Person:
    __slots__ = ('name', 'age')
```

此时：

```python
p = Person()
p.name = "Tom"
print(vars(p))  # 会报错
```

因为 `__slots__` 取消了实例字典结构。

在这种情况下，成员变量查询只能通过：

- `dir()`
- `getattr()`
- 直接访问

`__slots__` 的主要目的是节省内存。在大规模对象场景中性能提升明显。

---

## 九、总结与未来趋势

综上所述，Python 查询成员变量的核心方法包括：

- **调试探索：dir()**
- **精确获取：vars() / __dict__**
- **动态访问：getattr() / hasattr()**
- **高级反射：inspect 模块**

在现代 Python 开发中，随着类型提示（Type Hints）与数据类（dataclasses）的普及，成员变量的管理更加规范化。未来趋势包括：

- 更广泛使用 `dataclasses`
- 静态类型分析工具增强
- 更规范的元编程接口

理解 Python 对象模型与属性查找机制，是掌握成员变量查询的根本。**掌握正确的查询方式，不仅提升代码可维护性，也能避免潜在的运行时错误。**

---

参考与资料来源  
Python Software Foundation. Python 3 Documentation – Data Model, 2023.  
Ramalho, Luciano. Fluent Python, 2nd Edition, O’Reilly Media, 2022.

可以通过调用内置函数dir()来查看对象所有的属性和成员变量。例如，dir(obj)会返回一个列表，包含对象obj的所有属性和方法。另外，可以使用obj.__dict__获取对象的实例变量字典，里面存储了成员变量的名字和值。

使用内置函数查看对象的成员变量

我想知道在Python中，怎样能查看一个对象包含哪些成员变量？

如何查看Python对象中所有的成员变量？

Python内置的hasattr(object, 'attribute')函数可以用来判断对象是否拥有某个属性。如果返回True，则说明该属性是对象的成员变量或者其类的属性；返回False说明不存在该成员变量。

使用hasattr函数检查成员变量的存在

怎样在Python中判断一个属性是否属于某个对象的成员变量？

Python如何判断某个属性是否是对象的成员变量？

成员变量是属于对象实例的，每个实例有自己独立的成员变量。类变量是定义在类中的变量，被该类的所有实例共享。修改类变量会影响所有实例，而修改成员变量只影响对应实例。

成员变量与类变量的本质区别

我了解成员变量和类变量的概念，但不太清楚两者有什么区别，能简单解释一下吗？

Python中成员变量和类变量有什么区别？

PingCodeDocs

在 Python 中查询成员变量，关键在于区分类属性与实例属性，并选择合适的工具。常用方法包括 dir()、vars()、__dict__、getattr()、hasattr() 以及 inspect 模块。其中，vars() 和 __dict__ 适合精确获取实例变量，getattr() 与 hasattr() 适合动态访问，inspect 则适用于框架与元编程开发。同时需注意 __slots__ 会影响属性存储结构。理解 Python 对象模型与属性查找机制，是高效查询成员变量的基础。

python怎么查成员变量

用户关注问题