VSCode不能直接F5运行Scrapy爬虫，因scrapy crawl是命令行子命令，需用"module":"scrapy"启动并显式设置"cwd"为含scrapy.cfg的项目根目录，否则报Unknown command: crawl。
VSCode 不能直接 F5 运行 Scrapy 爬虫，因为 scrapy crawl 是命令行子命令，不是普通 Python 脚本；必须用模块模式启动，并确保工作目录落在项目根（含 scrapy.cfg）。
为什么直接点 F5 会报 Unknown command: crawl
VSCode 默认的 “Python File” 调试配置执行的是 python xxx.py，而 Scrapy 的 crawl 命令由 scrapy.cmdline.execute() 解析，依赖当前工作路径下存在 scrapy.cfg 文件来识别项目结构。如果 cwd 不对，框架连命令列表都加载不出来。
-
cwd必须显式设为项目根目录，比如"${workspaceFolder}"；若项目嵌套在子文件夹里，就得写死成"./my_scrapy_project" - 不能用
"program": "scrapy"或留空module字段——"module": "scrapy"是硬性要求 - 错误现象：控制台输出
Unknown command: crawl，或Scrapy 1.x - no active project
launch.json 怎么配才有效
配置本质是模拟终端里执行 scrapy crawl spider_name 的行为，但让调试器能介入。关键字段一个都不能少：
-
"module": "scrapy"：强制走模块入口，不是单文件执行 -
"args"顺序必须严格：["crawl", "spider_name", "-o", "out.json"]；第一个是子命令，第二个是Spider.name属性值，大小写/下划线必须完全一致 -
"console": "integratedTerminal"：否则日志刷不出来、input()卡死 - 示例片段：
{ "name": "Scrapy: crawl books", "type": "python", "request": "launch", "module": "scrapy", "args": ["crawl", "douban_book", "-o", "books.json"], "cwd": "${workspaceFolder}", "console": "integratedTerminal" }
断点为什么总不命中？别在 spiders/ 里打
Scrapy 的执行流是异步调度的：请求发出后，parse 回调由 Twisted reactor 触发，中间件、pipeline 里的函数也不在主线程栈上。VSCode 默认调试器进不去这些上下文。
- 优先在
start_requests或parse函数第一行设断点，确认主流程能停住 - 在
spiders/my_spider.py文件里打的断点大概率变空心圆——因为该文件不是被直接执行，而是被框架动态 import 实例化的 - 如果一定要调试 pipeline 或 downloader middleware，得用
run.py代理方式（补sys.path+os.chdir+execute()），再配"module": "runpy"启动它
解释器选错会导致 ModuleNotFoundError
Scrapy 依赖 Twisted、lxml、pywin32（Windows）等 C 扩展，系统 Python 或未装全依赖的环境大概率 import 失败，报 ModuleNotFoundError 或 Unhandled error in Deferred。
- 必须用项目专属虚拟环境：
python -m venv .venv→ 激活 →pip install scrapy - VSCode 中按
Ctrl+Shift+P→Python: Select Interpreter→ 手动选中.venv/bin/python（macOS/Linux）或.venv\Scripts\python.exe（Windows） - 右下角状态栏必须显示带
.venv路径的解释器，且无 “unavailable” 提示
真正卡住人的从来不是语法，而是工作目录、模块加载路径和异步调度这三者的错位。哪怕 launch.json 少一个引号，或者 cwd 指向了 spiders/ 子目录，整个调试链就断了——而错误信息往往只说 “command not found”，根本不会告诉你路径错了。
