# Python WiFi 监测与连接脚本 针对您在 Windows 环境下运行 Python 脚本的需求，以下提供一套完整的 Python 代码方案。该方案使用了 `pywifi` 库，这是 Windows 环境下操作 WiFi 最常用的第三方库，能够方便地实现扫描周边网络、获取信号强度以及自动连接指定 WiFi 的功能。 ## 一、 环境准备 在使用脚本之前，需要确保您的 Python 环境中已经安装了必要的库。请打开命令行（CMD 或 PowerShell）执行以下安装命令： ```powershell pip install pywifi comtypes ``` > **注意**：`comtypes` 是 `pywifi` 在 Windows 上运行所依赖的底层库，必须一并安装。 ## 二、 完整功能脚本 以下脚本集成了**WiFi 扫描**、**信号强度排序**以及**自动连接**三大核心功能。代码中包含了详细的中文注释，解释了每一步的操作逻辑。 ```python import pywifi import time import const def scan_and_display_wifi(): """ 扫描周边 WiFi 网络并打印详细信息 """ print("[*] 正在初始化无线网卡...") wifi = pywifi.PyWiFi() # 获取第一个无线网卡接口（通常机器只有一个无线网卡） iface = wifi.interfaces()[0] print("[*] 开始扫描周边网络，请稍候...") iface.scan() # 触发扫描 time.sleep(2) # 等待扫描完成，给网卡一点时间获取数据 # 获取扫描结果 scan_results = iface.scan_results() # 表头打印 print(f"{'序号':<5} | {'SSID (网络名称)':<20} | {'信号强度':<10} | {'加密方式'}") print("-" * 60) # 遍历并显示结果 for index, network in enumerate(scan_results): # network.signal 通常是负值，绝对值越小信号越强 # network.akm 是认证密钥管理列表，用于判断加密类型 ssid = network.ssid if network.ssid else "(隐藏网络)" signal = network.signal auth = str(network.akm) print(f"{index+1:<5} | {ssid:<20} | {signal:<10} | {auth}") return scan_results def connect_wifi(target_ssid, password): """ 尝试连接到指定的 WiFi 网络 参数: target_ssid (str): 目标 WiFi 的名称 password (str): WiFi 密码 """ wifi = pywifi.PyWiFi() iface = wifi.interfaces()[0] # 1. 断开当前连接 iface.disconnect() # 等待断开生效 time.sleep(1) # 检查网卡当前状态，如果正在连接中则稍作等待 if iface.status() in [const.IFACE_CONNECTED, const.IFACE_CONNECTING]: print("[!] 警告：网卡似乎仍处于连接状态，尝试强制断开...") return False # 2. 创建 WiFi 连接配置文件 profile = pywifi.Profile() profile.ssid = target_ssid # WiFi 名称 profile.auth = const.AUTH_ALG_OPEN # 认证算法，一般开放系统认证 # 设置加密类型为 WPA2PSK (目前最常见的家庭路由器加密方式) profile.akm.append(const.AKM_TYPE_WPA2PSK) # 设置加密算法为 AES (通常配合 WPA2 使用) profile.cipher = const.CIPHER_TYPE_CCMP profile.key = password # 填写密码 # 3. 清理旧配置文件并添加新配置 # 移除网卡上所有同名的配置文件，防止冲突 iface.remove_all_network_profiles() tmp_profile = iface.add_network_profile(profile) print(f"[*] 正在尝试连接到: {target_ssid} ...") # 4. 执行连接 iface.connect(tmp_profile) # 5. 等待连接建立 (等待 5 秒) time.sleep(5) # 6. 验证连接结果 if iface.status() == const.IFACE_CONNECTED: print(f"[+] 成功连接到 {target_ssid}!") return True else: print(f"[!] 连接失败。请检查密码是否正确，或信号是否过弱。") return False if __name__ == "__main__": # --- 第一步：执行扫描 --- networks = scan_and_display_wifi() # --- 第二步：用户交互选择 --- print("\n请输入您想要连接的 WiFi 名称 (SSID):") target_ssid = input("SSID: ").strip() # 简单的逻辑检查：看输入的名称是否在扫描列表中 found = False for net in networks: if net.ssid == target_ssid: found = True break if not found: print(f"[!] 警告：扫描结果中未找到 '{target_ssid}'，可能是信号太弱或未开启。") print("[*] 脚本仍将尝试连接...") target_password = input("请输入密码: ").strip() # --- 第三步：执行连接 --- connect_wifi(target_ssid, target_password) ``` ## 三、 代码核心逻辑解析 为了帮助您更好地理解脚本，以下对关键部分进行深度解析： | 代码模块 | 功能说明 | 关键点 | | :--- | :--- | :--- | | **`pywifi.PyWiFi()`** | 初始化 WiFi 控制对象 | 这是操作 WiFi 的入口，用于获取无线网卡列表。 | | **`iface.scan()`** | 触发网卡扫描 | 这是一个异步过程，调用后必须使用 `time.sleep()` 等待几秒，否则获取不到结果。 | | **`pywifi.Profile()`** | 创建连接配置文件 | 这是一个核心对象，必须指定 SSID、加密算法（AKM）和密码。对于 WPA2/WPA3 混合路由器，通常使用 `AKM_TYPE_WPA2PSK`。 | | **`iface.connect()`** | 发起连接请求 | 同样是异步的，连接后需要轮询状态或等待一段时间来确认是否成功。 | | **`const.IFACE_CONNECTED`** | 状态常量 | 用于判断网卡当前是否已成功获取 IP 地址并连接到 AP。 | ## 四、 常见问题与调试 1. **权限不足**： * 在 Windows 上运行此脚本时，**必须以“管理员身份”** 运行 CMD 或 IDE（如 PyCharm、VS Code）。否则，脚本无法修改网络配置，连接步骤会报错或无反应。 2. **编码报错**： * 如果遇到 UnicodeDecodeError，通常是因为 WiFi 名称包含中文或特殊字符。可以在脚本开头添加以下代码来解决： ```python import sys import io sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8') ``` 3. **连接超时**： * 脚本中的 `time.sleep(5)` 是一个经验值。如果您的网络环境较慢（例如认证服务器响应慢），可以适当增加这个等待时间。 通过以上脚本，您可以灵活地在 Windows 环境下通过 Python 管理 WiFi 连接，无论是用于日常自动切换网络，还是集成到更大的自动化运维工具中，都能满足需求。