vscode 不自带 requests 和 bs4，需手动安装依赖并配置代码片段；“pycrawl”模板预置超时、ua、异常处理和 html.parser 解析器，确保开箱即用。
requests 和 bs4（即 beautifulsoup4）不是 VSCode 自带功能，也不能靠“一键模板”自动装好依赖或配置运行环境。所谓“快速生成爬虫模板”，本质是两件事：写好结构化代码骨架 + 确保运行时依赖就位。缺一不可，否则 Ctrl+F5 会直接报 ModuleNotFoundError。
为什么 pyfunc/pyclass 模板不能直接用于爬虫
VSCode 默认的 pyfunc、pyclass 等用户代码片段只负责语法结构，不处理导入、异常处理、编码声明或第三方库调用逻辑。爬虫脚本有固定模式：必须 import requests、通常要 from bs4 import BeautifulSoup、常需设置 headers、处理 response.status_code、容错 try/except。这些如果每次手敲，反而拖慢速度。
- 直接复用通用函数模板，容易漏掉
timeout=10导致请求卡死 - 没加
headers字段，目标网站返回 403 是大概率事件 -
bs4安装错成bs4（实际应为beautifulsoup4），pip install bs4会装一个空包，运行时报ImportError: No module named 'bs4'
如何手动添加一个真正可用的爬虫代码片段
打开 VSCode → 文件 → 首选项 → 用户代码片段 → 搜索并选择 python.json。在其中新增一个片段，例如名称为 pycrawl：
{
"Python Basic Crawler": {
"prefix": "pycrawl",
"body": [
"import requests",
"from bs4 import BeautifulSoup",
"",
"def fetch_page(url: str) -> BeautifulSoup | None:",
"\theaders = {\"User-Agent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36\"}",
"\ttry:",
"\t\tresponse = requests.get(url, headers=headers, timeout=10)",
"\t\tresponse.raise_for_status()",
"\t\treturn BeautifulSoup(response.content, \"html.parser\")",
"\texcept requests.RequestException as e:",
"\t\tprint(f\"Request failed: {e}\")",
"\t\treturn None",
"",
"if __name__ == \"__main__\":",
"\turl = \"${1:https://example.com}\"",
"\tsoup = fetch_page(url)",
"\tif soup:",
"\t\t${2:# extract data here}"
],
"description": "A ready-to-run crawler snippet with error handling and bs4 setup"
}
}
- 注意
BeautifulSoup的解析器指定为"html.parser"，避免因系统缺lxml导致报错 -
timeout=10是硬性建议，不设超时在调试时极易假死 -
response.raise_for_status()能自动抛出 4xx/5xx 异常，比手动检查status_code更可靠 - 片段末尾留了
${2:# extract data here}占位符，Tab 可跳转，方便立刻写soup.find_all("a")类逻辑
依赖必须提前装在当前 Python 环境里
代码片段再完善，import requests 这行执行失败，整个模板就只是文本。VSCode 不会替你运行 pip。
- 确认当前 VSCode 使用的 Python 解释器路径：按
Ctrl+Shift+P→ 输入Python: Select Interpreter→ 看右下角状态栏显示的路径 - 在这个解释器对应的终端中运行：
pip install requests beautifulsoup4（不是bs4，也不是request） - 如果用了虚拟环境（推荐），确保 VSCode 已选中该环境下的
python.exe或bin/python，否则 pip 装到全局环境也白搭 - 装完后重启 VSCode 终端，或执行
python -c "import requests, bs4; print('ok')"验证
常见报错与对应检查点
写了 pycrawl 模板却跑不起来？先盯住这三行错误信息：
-
ModuleNotFoundError: No module named 'requests'→ 检查pip list输出里有没有requests，以及 VSCode 当前解释器是否和 pip 所在环境一致 -
AttributeError: 'NoneType' object has no attribute 'find'→fetch_page()返回了None，说明请求失败，看控制台是否打印了Request failed:日志 -
UnicodeDecodeError: 'gbk' codec can't decode byte→response.content没用对解析器，改成response.text并显式指定编码（如response.content.decode("utf-8")），或坚持用BeautifulSoup(response.content, "html.parser")（更健壮）
真正省时间的不是“多一个模板”，而是模板里把爬虫最常踩的坑——超时、UA、异常、编码、解析器——都预先兜住。剩下的，就是填 URL 和写提取逻辑了。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
