Eclipse PyDev 導入 Scapy 找不到 IP 類：動態導入機制導致靜態分析誤報

在 Eclipse PyDev 中 `from scapy.all import *` 後，編輯器提示 `Undefined variable: IP`，但程式實際執行正常。這是因為 Scapy 使用**動態模組導入機制**（`__getattr__`、`__dir__`、`import hooks`），靜態分析器無法掃描出運行時才注入的符號。本文解釋原理並給出三種解決方案。

現象

from scapy.all import *
# 或
from scapy.all import IP

test_ip = IP(dst="192.168.1.1", src="192.168.1.2")  # 運行完全正常
# PyDev 編輯器紅線：Undefined variable: IP

根本原因

• `scapy/all.py` 定義了 `__all__` 列表，但實際類別（`IP`、`TCP`、`Ether` 等）在**子模組**中（`scapy.layers.inet`、`scapy.layers.l2`）
• `scapy.all` 使用**延遲導入**：只有當代碼真正訪問 `IP` 時，透過 `__getattr__` 動態從子模組載入並注入到 `scapy.all` 命名空間
• PyDev / PyLint / Jedi 等靜態分析器**不執行代碼**，只掃描 AST，因此看不到動態注入的符號

方案一：顯式從子模組導入（推薦，消除紅線）

# 明確告訴靜態分析器類別在哪裡
from scapy.layers.inet import IP, TCP, UDP, ICMP
from scapy.layers.l2 import Ether, ARP
from scapy.packet import Raw
from scapy.sendrecv import send, sniff, sr1

# 現在 PyDev 能正確解析 IP、TCP 等
pkt = IP(dst="192.168.1.1")/TCP(dport=80)
send(pkt)

方案二：PyDev 忽略特定導入錯誤

1. `Window` → `Preferences` → `PyDev` → `Editor` → `Code Analysis`
2. 展開 `Undefined` → 勾選 `Add to ignored` → 新增模式：`scapy.*`
3. 或在代碼加註解抑制：`# @UndefinedVariable`

方案三：使用 Scapy 官方建議的導入方式

# 官方文件推薦：只導入 all，運行時動態解析
from scapy.all import *
# 代碼提示雖然有紅線，但功能完整

# 若需代碼提示，可配合方案一混用
from scapy.all import *          # 運行時用
from scapy.layers.inet import IP # 靜態分析/提示用

驗證 Scapy 動態導入機制

import scapy.all as scapy
print('IP' in dir(scapy))           # False (未訪問前)
ip = scapy.IP()                     # 觸發 __getattr__
print('IP' in dir(scapy))           # True (訪問後注入)
print(scapy.IP is scapy.layers.inet.IP)  # True

常用 Scapy 類別對應子模組速查

總結

**運行正常、編輯器紅線**是 Scapy 動態導入特性決定的。**顯式從子模組導入**可同時滿足運行與靜態分析；或在 PyDev 設定忽略 `scapy.*` 未定義變數檢查。不影響任何功能，放心使用。