VSCode直接F5无法调试Scrapy爬虫，因其依赖scrapy.cfg所在目录识别项目结构；必须配置launch.json使用"module":"scrapy"、显式指定"cwd"为项目根路径，并绑定正确虚拟环境解释器。
直接在 VSCode 里点 F5 是跑不起来 Scrapy 爬虫的，因为 scrapy 不是普通 Python 脚本，它依赖项目根目录下的 scrapy.cfg 和当前工作路径来识别项目结构。没配对路径和模块入口，调试器连 crawl 命令都找不到。
launch.json 必须设 "module": "scrapy" 并指定 cwd
VSCode 默认的 “Python File” 调试配置走的是单文件执行路径，而 scrapy crawl xxx 是命令行子命令，必须用模块模式启动，并确保工作目录（cwd）落在 Scrapy 项目根（即含 scrapy.cfg 的目录）。否则会报 Unknown command: crawl。
-
"module": "scrapy"是硬性要求，不能写成"program": "scrapy"或留空 -
"cwd"必须显式设置为项目根路径，比如"${workspaceFolder}"；如果项目不在工作区根，得写死成"./my_scrapy_project" -
"args"顺序要严格：第一个是"crawl"，第二个是爬虫名（spider.name），后续可加-o、-s等参数 - 示例片段：
{ "name": "Scrapy: crawl books", "type": "python", "request": "launch", "module": "scrapy", "args": ["crawl", "douban_book", "-o", "books.json"], "cwd": "${workspaceFolder}", "console": "integratedTerminal" }
别用系统 Python 解释器，必须绑定项目虚拟环境
Scrapy 依赖 Twisted、lxml、pywin32（Windows）等 C 扩展，系统 Python 或未装全依赖的环境大概率 import 失败，报 ModuleNotFoundError 或 Unhandled error in Deferred。
- 在项目根运行
python -m venv .venv创建隔离环境 - 激活后执行
pip install scrapy（不要只装requests就以为够了） - VSCode 中按
Ctrl+Shift+P→Python: Select Interpreter→ 手动选中.venv/bin/python（macOS/Linux）或.venv\Scripts\python.exe（Windows） - 右下角状态栏必须显示带
.venv路径的解释器，且无 “unavailable” 提示
断点不命中？检查是不是在中间件、pipeline 或异步回调里设的
Scrapy 的执行流不是线性的：请求发出去后，parse 回调由 Twisted reactor 异步调度；process_request、process_response 在 downloader middleware 中运行；process_item 在 pipeline 里触发——这些位置 VSCode 默认调试器进不去，断点会变灰。
立即学习“Python免费学习笔记（深入）”；
- 优先在
start_requests或parse函数开头设断点，确认主流程能停住 - 若需调试 middleware，把逻辑临时移到
parse里验证逻辑，再搬回去 - 异步场景（如
aiohttp+async def parse）目前 VSCode Python 调试器不支持，得改用logging.debug()打桩 - 想查
response内容？直接在parse里加import pdb; pdb.set_trace()，配合integratedTerminal可交互
想快速试 CSS/XPath 表达式？用 scrapy shell 而不是硬调
VSCode 里没法图形化打开 scrapy shell，但它完全可以在内置终端中跑，比反复启 crawl 快得多，也避免污染日志和输出。
- 按
Ctrl+`打开终端，确保已 cd 进 Scrapy 项目根目录 - 运行
scrapy shell "https://example.com"，会加载response对象并进入交互环境 - 直接敲
response.css("title::text").get()或response.xpath("//h1/text()").get()实时验证 - 若已安装
ipython，会自动启用增强提示；没装就用默认 Python shell，功能不受影响
真正卡住的地方往往不是 launch.json 写错，而是 cwd 没对上 scrapy.cfg 位置，或者解释器没绑对虚拟环境——这两个点漏掉一个，整个调试链就断在第一跳。
