{"id":50709219,"url":"https://github.com/coowinit/hp-printer-troubleshooting-guide","last_synced_at":"2026-06-09T14:01:45.899Z","repository":{"id":363475813,"uuid":"1263520507","full_name":"coowinit/hp-printer-troubleshooting-guide","owner":"coowinit","description":"一个面向办公室和企业环境的打印机故障排查知识库，涵盖 Windows 打印队列、Print Spooler、WSD 与 TCP/IP 端口、网络打印机 IP 配置、驱动安装、打印机脱机、共享打印机和企业部署最佳实践。","archived":false,"fork":false,"pushed_at":"2026-06-09T04:08:36.000Z","size":58,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-09T05:14:51.543Z","etag":null,"topics":["hp-printer","it-support","network-printer","office-it","print-spooler","printer-driver","system-administration","tcp-ip-port","troubleshooting","windows","wsd"],"latest_commit_sha":null,"homepage":"","language":"Batchfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/coowinit.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-09T03:07:27.000Z","updated_at":"2026-06-09T04:08:40.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/coowinit/hp-printer-troubleshooting-guide","commit_stats":null,"previous_names":["coowinit/hp-printer-troubleshooting-guide"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/coowinit/hp-printer-troubleshooting-guide","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coowinit%2Fhp-printer-troubleshooting-guide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coowinit%2Fhp-printer-troubleshooting-guide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coowinit%2Fhp-printer-troubleshooting-guide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coowinit%2Fhp-printer-troubleshooting-guide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coowinit","download_url":"https://codeload.github.com/coowinit/hp-printer-troubleshooting-guide/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coowinit%2Fhp-printer-troubleshooting-guide/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34110012,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hp-printer","it-support","network-printer","office-it","print-spooler","printer-driver","system-administration","tcp-ip-port","troubleshooting","windows","wsd"],"created_at":"2026-06-09T14:01:44.991Z","updated_at":"2026-06-09T14:01:45.893Z","avatar_url":"https://github.com/coowinit.png","language":"Batchfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🖨️ 打印机故障排查知识库\n\n![Platform](https://img.shields.io/badge/Platform-Windows-blue)\n![Topic](https://img.shields.io/badge/Topic-Printer%20Troubleshooting-green)\n![Version](https://img.shields.io/badge/Version-v1.5.0-success)\n\n\u003e 一个面向办公室和企业环境的中文打印机故障排查知识库，涵盖 Windows 打印队列、Print Spooler、打印缓存清理、WSD 与 TCP/IP 端口、网络打印机固定 IP、IP 变化、Ping 网络检测、打印机脱机、驱动安装重装、打印乱码、共享打印机、企业部署规范和故障速查总表。\n\n---\n\n## 📌 当前版本\n\n```text\nv1.5.0 - 新增共享打印机、企业部署规范和故障速查总表\n```\n\n本版本在 v1.4.0 的驱动安装、重装与打印乱码专题基础上，继续补充企业环境中更常见的共享打印、标准化部署和快速定位能力：\n\n- 共享打印机故障排查流程\n- 共享主机、权限、凭据、防火墙和客户端驱动检查方法\n- 企业打印机部署规范与最佳实践\n- 打印机命名、固定 IP / DHCP 保留、TCP/IP 端口和官方驱动统一建议\n- 打印机设备登记表、部署前检查清单和变更记录模板\n- 打印机常见故障速查总表，便于 Helpdesk 快速定位问题\n\n---\n\n## 📚 文档导航\n\n### 真实排查案例\n\n| 文档                                                                                | 说明                                                                                                                                                                                                                                          |\n| --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| [HP 网络打印机故障排查与 TCP/IP 端口优化指南](docs/printer/hp-network-printer-troubleshooting.md) | 这是一个可长期复用的真实打印机故障排查案例，基于 HP LaserJet Professional M1216nfh MFP 网络打印机的实际处理过程整理。文档完整记录了打印无反应、任务卡在队列、测试页无法打印、Print Spooler 服务异常、WSD 端口不稳定以及切换为 Standard TCP/IP Port 的完整排查与优化流程。后续遇到类似的网络打印机无法打印、队列卡住、端口异常或 IP 配置问题时，可直接参考本案例进行快速判断、逐步排查和标准化处理。 |\n\n### 打印队列与系统服务\n\n| 文档 | 说明 |\n|---|---|\n| [打印队列卡住、Print Spooler 与清空缓存指南](docs/printer/printer-queue-spooler-cache-guide.md) | 系统说明打印任务卡住的现象、原因、排查流程、Print Spooler 重启方法，以及手动清空 spool 打印缓存的完整步骤。 |\n\n### 网络端口与 IP 配置\n\n| 文档 | 说明 |\n|---|---|\n| [WSD 与 TCP/IP 打印端口专题](docs/printer/wsd-vs-tcpip-port.md) | 说明 WSD 与 Standard TCP/IP Port 的区别、适用场景、常见问题和企业环境推荐配置。 |\n| [网络打印机固定 IP 与 DHCP 保留配置建议](docs/printer/printer-static-ip-guide.md) | 说明打印机固定 IP、DHCP 保留、IP 冲突、IP 变化后的处理流程和企业设备登记建议。 |\n\n### 网络检测与脱机排查\n\n| 文档 | 说明 |\n|---|---|\n| [打印机脱机状态排查指南](docs/printer/printer-offline-troubleshooting.md) | 处理打印机显示脱机、状态异常、网络不通、端口错误和 Windows 误判脱机等问题。 |\n| [打印机 IP 变化导致无法打印排查指南](docs/printer/printer-ip-changed.md) | 说明打印机 IP 变化原因、旧端口失效判断方法、端口 IP 修改和 DHCP 保留建议。 |\n| [Ping 网络检测与打印机连通性排查指南](docs/printer/printer-ping-network-check.md) | 使用 Ping、ipconfig、连续 Ping 和浏览器访问打印机后台来判断网络连通性。 |\n\n### 驱动与输出异常\n\n| 文档 | 说明 |\n|---|---|\n| [打印机驱动安装、卸载与重装指南](docs/printer/printer-driver-install-reinstall-guide.md) | 说明打印机驱动安装、干净重装、官方驱动与通用驱动区别、PCL / PS 驱动选择和企业统一驱动建议。 |\n| [打印乱码、格式错乱与输出异常排查指南](docs/printer/printer-garbled-output-troubleshooting.md) | 处理打印乱码、中文方框、PDF 打印错位、字体缺失、表格错乱、偶发输出异常等问题。 |\n\n### 共享打印机与企业部署\n\n| 文档 | 说明 |\n|---|---|\n| [共享打印机故障排查指南](docs/printer/shared-printer-troubleshooting.md) | 处理共享打印机无法连接、访问被拒绝、共享主机不可用、客户端驱动异常和防火墙阻止等问题。 |\n| [企业打印机部署规范与最佳实践](docs/printer/printer-enterprise-deployment-standard.md) | 说明企业环境中打印机命名、固定 IP / DHCP 保留、TCP/IP 端口、官方驱动、设备登记和变更记录建议。 |\n| [打印机常见故障速查总表](docs/printer/printer-common-errors-quick-reference.md) | 汇总打印队列、脱机、IP 变化、Ping、端口、驱动、乱码和共享打印机等常见故障的快速判断方法。 |\n\n---\n\n## 🚀 快速处理流程\n\n当用户反馈“打印不了”时，可以先按下面顺序判断：\n\n```text\n确认打印机开机\n    ↓\n检查是否显示脱机\n    ↓\n检查打印队列是否卡住\n    ↓\n重启 Print Spooler，必要时清空缓存\n    ↓\n确认端口类型：WSD / TCP/IP\n    ↓\nPing 打印机 IP\n    ↓\n检查打印机 IP 是否变化\n    ↓\n打印 Windows 测试页\n    ↓\n测试页正常但软件异常：检查驱动 / 软件 / 文件 / 字体\n    ↓\n测试页异常：检查驱动 / 端口 / 打印机本体\n    ↓\n必要时重装官方驱动\n    ↓\n如果是共享打印机，检查共享主机 / 权限 / 凭据 / 防火墙\n    ↓\n按企业部署规范统一 IP、端口、驱动和设备登记\n```\n\n---\n\n## 🧭 推荐排查思路\n\n### 1. 任务卡住类问题\n\n优先查看：\n\n```text\n打印队列\nPrint Spooler\nspool 缓存目录\n```\n\n### 2. 网络不通类问题\n\n优先查看：\n\n```text\n打印机 IP\nPing 测试\n网线 / Wi-Fi\n同网段情况\n```\n\n### 3. 端口不稳定类问题\n\n优先查看：\n\n```text\n当前是否使用 WSD\n是否已切换 TCP/IP\nTCP/IP 端口 IP 是否正确\n```\n\n### 4. 驱动与乱码类问题\n\n优先查看：\n\n```text\nWindows 测试页\n官方驱动 / 通用驱动\nPCL / PS 驱动语言\nPDF 是否需要作为图像打印\n字体是否缺失或未嵌入\n```\n\n### 5. 共享打印机类问题\n\n优先查看：\n\n```text\n共享主机是否开机\n共享主机本机能否打印\n客户端能否访问 \\\\主机名\n共享权限 / Windows 凭据 / 防火墙\n客户端驱动是否匹配\n```\n\n### 6. 企业部署类问题\n\n优先采用：\n\n```text\nDHCP 保留\nStandard TCP/IP Port\n官方驱动\n统一打印机命名\n统一设备登记表\n统一驱动版本\n故障速查表\n```\n\n---\n\n## 🗂️ 目录结构\n\n```text\nprinter-troubleshooting-knowledge-base/\n├── README.md\n├── CHANGELOG.md\n├── docs/\n│   └── printer/\n│       ├── README.md\n│       ├── hp-network-printer-troubleshooting.md\n│       ├── printer-queue-spooler-cache-guide.md\n│       ├── wsd-vs-tcpip-port.md\n│       ├── printer-static-ip-guide.md\n│       ├── printer-offline-troubleshooting.md\n│       ├── printer-ip-changed.md\n│       ├── printer-ping-network-check.md\n│       ├── printer-driver-install-reinstall-guide.md\n│       ├── printer-garbled-output-troubleshooting.md\n│       ├── shared-printer-troubleshooting.md\n│       ├── printer-enterprise-deployment-standard.md\n│       └── printer-common-errors-quick-reference.md\n├── images/\n│   └── printer/\n└── scripts/\n    └── windows/\n        └── clear-printer-queue.bat\n```\n\n---\n\n## 🛠️ 脚本工具\n\n| 脚本 | 说明 |\n|---|---|\n| [clear-printer-queue.bat](scripts/windows/clear-printer-queue.bat) | 停止 Print Spooler、清空 Windows 打印缓存、重新启动 Print Spooler。 |","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoowinit%2Fhp-printer-troubleshooting-guide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoowinit%2Fhp-printer-troubleshooting-guide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoowinit%2Fhp-printer-troubleshooting-guide/lists"}