Python wakepy 包完整使用指南wakepy是轻量级、跨平台的 Python 库核心功能是临时阻止系统进入休眠、锁屏、睡眠、屏幕关闭无需管理员权限兼容 Windows、macOS、Linux 三大系统纯 Python 实现无额外依赖适合需要长时间运行、保持系统活跃的脚本/程序。一、核心功能阻止系统休眠让电脑保持唤醒不进入睡眠/休眠模式阻止屏幕关闭保持屏幕常亮部分系统支持跨平台兼容自动适配 Windows、macOS、Linux无依赖、轻量仅 100KB 左右纯 Python 实现两种使用方式上下文管理器推荐、装饰器安全自动恢复程序结束/异常退出后自动恢复系统原休眠设置二、安装方法基础安装无额外依赖pipinstallwakepy完整安装包含所有平台优化功能pipinstallwakepy[full]版本验证安装后检查是否成功pip show wakepy推荐使用0.8.0稳定版本。三、核心语法与参数1. 核心导入# 基础唤醒阻止休眠fromwakepyimportkeepawake# 高级同时保持唤醒屏幕常亮部分系统fromwakepyimportkeepawake,ActivationType2. 核心参数keepawake()支持以下关键参数参数类型默认值说明keep_screen_onboolFalse是否保持屏幕常亮True亮屏False仅后台唤醒activation_typeActivationTypeAUTO唤醒模式自动/手动选择系统方法methodslistNone手动指定唤醒方法高级用法on_failurecallableNone唤醒失败时的回调函数3. 两种使用语法语法1上下文管理器推荐最安全自动管理唤醒生命周期代码块结束自动关闭唤醒withkeepawake(keep_screen_onTrue):# 你的代码此区间内系统不会休眠pass语法2装饰器适合函数keepawake(keep_screen_onFalse)deflong_running_task():# 函数执行期间保持唤醒pass四、8个实际应用案例可直接运行案例1基础用法 - 长时间下载文件场景下载大文件时防止电脑休眠中断下载fromwakepyimportkeepawakeimportrequestsdefdownload_large_file():# 保持唤醒屏幕可关闭省电withkeepawake(keep_screen_onFalse):urlhttps://example.com/large-file.zipresponserequests.get(url,streamTrue)withopen(large-file.zip,wb)asf:forchunkinresponse.iter_content(chunk_size1024):f.write(chunk)print(下载完成)download_large_file()案例2亮屏模式 - 长时间展示数据场景报表展示、监控面板、演示时保持屏幕常亮fromwakepyimportkeepawakeimporttime# 保持唤醒屏幕常亮withkeepawake(keep_screen_onTrue):print(屏幕将保持常亮 10 分钟)time.sleep(600)# 10分钟print(任务结束恢复系统设置)案例3装饰器用法 - 定时爬虫场景长时间爬虫任务函数执行期间保持唤醒fromwakepyimportkeepawakeimporttimeimportrequestskeepawake(keep_screen_onFalse)# 仅后台唤醒defscrape_website():forpageinrange(1,20):print(f正在爬取第{page}页...)requests.get(https://example.com/page/{}.format(page))time.sleep(3)print(爬虫完成)scrape_website()案例4异常安全 - 数据处理/训练任务场景数据清洗、模型训练即使报错也能自动恢复系统设置fromwakepyimportkeepawakeimportpandasaspd# 上下文管理器自带异常安全无需手动处理withkeepawake():print(开始数据处理...)dfpd.read_csv(data.csv)# 模拟可能出错的代码resultdf.groupby(category).sum()result.to_csv(output.csv)print(数据处理完成)案例5Linux 专用 - 服务器脚本保活场景Linux 服务器运行定时任务防止系统休眠fromwakepyimportkeepawakeimportsubprocess# Linux 下自动使用 dbus/gnome 休眠抑制withkeepawake():# 执行服务器脚本subprocess.run([python3,server_task.py],checkTrue)print(服务器任务执行完成)案例6Windows 专用 - 办公自动化任务场景Excel 处理、报表生成、Windows 办公脚本fromwakepyimportkeepawakeimportopenpyxlwithkeepawake(keep_screen_onTrue):# 打开并处理大型Excel文件wbopenpyxl.load_workbook(report.xlsx)wswb.active ws[A1]处理完成wb.save(report_final.xlsx)print(Excel 处理完成)案例7macOS 专用 - 视频渲染/导出场景macOS 视频剪辑、文件导出防止中途休眠fromwakepyimportkeepawakeimportsubprocess# macOS 使用 caffeinate 命令无权限要求withkeepawake():# 调用ffmpeg渲染视频subprocess.run([ffmpeg,-i,input.mp4,-c:v,libx264,output.mp4],checkTrue)print(视频渲染完成)案例8循环任务 - 7x24小时监控脚本场景监控系统状态、接口保活永久保持唤醒fromwakepyimportkeepawakeimporttimeimportrequestsdefcheck_api_status():try:requests.get(https://your-api.com/health,timeout5)return正常except:return异常# 永久保持唤醒withkeepawake():whileTrue:statuscheck_api_status()print(f接口状态{status}| 时间{time.ctime()})time.sleep(60)# 每分钟检查一次五、常见错误与解决方案错误1导入失败ModuleNotFoundError: No module named wakepy原因未安装包 / 安装环境与运行环境不一致解决# 重新安装pipinstallwakepy# 若使用虚拟环境先激活环境再安装错误2唤醒功能不生效原因系统不支持当前唤醒方法程序提前退出上下文管理器未执行完毕Linux 无桌面环境纯命令行解决使用keepawake(activation_typeFALLBACK)确保代码块完整执行Linux 纯命令行需安装systemd-inhibit错误3keep_screen_onTrue屏幕仍熄灭原因Windows 家庭版/部分Linux不支持亮屏控制系统手动设置优先级高于 wakepy解决仅使用keep_screen_onFalse保证后台唤醒即可临时手动调整系统电源设置错误4程序崩溃后系统无法恢复休眠原因强制杀死进程上下文管理器未执行清理解决不要用kill -9/ 任务管理器强制结束手动重启电脑即可恢复默认设置wakepy 不修改系统永久配置错误5Linux 下提示dbus相关错误原因缺少桌面依赖解决# 安装完整版本pipinstallwakepy[full]# 或使用回退模式with keepawake(methods[FALLBACK]): pass六、使用注意事项无永久修改wakepy 仅临时抑制休眠不会修改系统电源设置程序结束自动恢复权限要求无需管理员/root权限普通用户即可使用亮屏限制keep_screen_onTrue并非所有系统都支持优先保证「后台唤醒」兼容性Windows完美支持所有版本macOS完美支持使用原生 caffeinateLinux桌面版完美支持纯命令行需 fallback 模式嵌套禁用不要嵌套使用with keepawake()会导致功能异常长任务推荐必须使用上下文管理器比装饰器更安全、更易调试省电建议非必要不开启keep_screen_onTrue可大幅省电总结核心价值轻量、跨平台、无依赖、自动恢复系统设置核心用法with keepawake(keep_screen_onFalse):包裹长任务代码适用场景下载、爬虫、数据处理、模型训练、视频渲染、监控脚本安全原则用上下文管理器不强制杀进程无需管理员权限常见问题导入失败→重装不生效→用回退模式亮屏失效→系统不支持《动手学PyTorch建模与应用:从深度学习到大模型》是一本从零基础上手深度学习和大模型的PyTorch实战指南。全书共11章前6章涵盖深度学习基础包括张量运算、神经网络原理、数据预处理及卷积神经网络等后5章进阶探讨图像、文本、音频建模技术并结合Transformer架构解析大语言模型的开发实践。书中通过房价预测、图像分类等案例讲解模型构建方法每章附有动手练习题帮助读者巩固实战能力。内容兼顾数学原理与工程实现适配PyTorch框架最新技术发展趋势。