正确做法是先用open()读取本地HTML文件并指定编码，再将文件对象或内容传给BeautifulSoup解析；推荐使用"html.parser"，避免直接传路径或调用网络请求方法。
直接用 open() 读文件再传给 BeautifulSoup 就行
本地 HTML 文件不是 URL，别调 requests.get() 或 urlopen() —— 那是为网络请求设计的，本地文件走文件系统更稳、更快、不依赖网络。核心就是：先用 Python 标准库打开文件，再把内容丢给 BeautifulSoup 解析。
注意编码问题：很多本地网页（尤其中文）是 gbk 或 gb2312 编码，直接用默认 utf-8 会报 UnicodeDecodeError。建议显式指定编码，或用 chardet 自动探测（但小范围已知编码时手动指定更可靠）。
示例：
from bs4 import BeautifulSoup
with open("page.html", "r", encoding="gbk") as f:
soup = BeautifulSoup(f, "html.parser")
print(soup.title.text)
BeautifulSoup 的 parser 参数选哪个？
离线解析对 parser 要求不高，但选错会影响容错性和速度。常见选项：
立即学习“Python免费学习笔记（深入）”；
-
"html.parser"：Python 内置，无需额外安装，对常见乱码、标签嵌套错误容忍度尚可，适合大多数本地静态页 -
"lxml"：速度快、修复能力强（比如自动闭合<img>），但需pip install lxml；遇到编码声明混乱时可能比html.parser更“激进”地重写文档结构 -
"html5lib"：最接近浏览器行为，修复最彻底，但极慢，且必须pip install html5lib；本地调试用它容易掩盖原始 HTML 问题，不推荐默认使用
结论：没特殊需求就用 "html.parser"；若页面结构脏、标签严重不闭合，再换 "lxml"。
相对路径资源（如 <img src="images/logo.png">）怎么处理？
BeautifulSoup 只负责解析 DOM 树，不会自动补全或验证路径。如果你后续要提取图片路径、检查资源是否存在，得自己拼接绝对路径：
- 用
os.path.join(os.path.dirname(file_path), src_attr)构建完整路径 - 注意
src值可能含"./"、"../"或以"/"开头（表示根目录），需按实际文件位置做归一化 - 别直接用
urllib.parse.urljoin()—— 它是为 URL 设计的，对本地路径中的".."处理不一致，容易出错
示例（安全拼接）：
import os
from bs4 import BeautifulSoup
file_path = "data/report.html"
with open(file_path, "r", encoding="utf-8") as f:
soup = BeautifulSoup(f, "html.parser")
for img in soup.find_all("img", src=True):
src = img["src"]
abs_path = os.path.normpath(os.path.join(os.path.dirname(file_path), src))
if os.path.exists(abs_path):
print("✅ Found:", abs_path)
else:
print("❌ Missing:", abs_path)
为什么解析结果和浏览器开发者工具看到的不一样？
这是离线解析最常被忽略的点：浏览器会执行 JavaScript、补全缺失标签、动态修改 DOM；而 BeautifulSoup 只解析原始 HTML 字符串，不做任何执行或重渲染。
所以如果网页依赖 JS 渲染内容（比如通过 fetch 加载数据后插入 <div id="content"></div>），你用 BeautifulSoup 拿到的就是空的 <div></div> —— 不是解析错了，是它本来就没内容。
判断方法很简单：用文本编辑器直接打开那个 HTML 文件，搜索你要找的关键文字。搜不到，BeautifulSoup 就一定拿不到。
需要处理 JS 渲染页？那就不是 BeautifulSoup 的事了，得上 Playwright 或 Selenium 启动真实浏览器环境。
