PyCharm运行Scrapy项目必须通过cmdline.py配置Run/Debug或用main.py封装execute()，不可直接右键运行spider.py；因缺失scrapy.cfg、settings.py加载及sys.path注入，否则报ModuleNotFoundError、Unknown command: crawl或断点不命中。
在PyCharm中运行Scrapy项目必须绕过直接右键执行spider.py的惯性操作，否则会因缺失项目上下文、scrapy.cfg读取失败或sys.path未注入而报ModuleNotFoundError、Unknown command: crawl或断点完全不命中。
用cmdline.py配置Run/Debug Configuration（推荐）
这是最稳定、可复用、且与终端行为完全一致的方式，本质是让PyCharm模拟真实终端执行scrapy crawl的全过程。
第一步：打开Run → Edit Configurations → 点击+号 → 选择Python。
第二步：Script path填scrapy/cmdline.py的绝对路径——【必须是完整路径，不能用相对路径或自动补全】。Windows示例：C:\Python311\Lib\site-packages\scrapy\cmdline.py；Mac/Linux示例：/usr/local/lib/python3.11/site-packages/scrapy/cmdline.py。快速定位方法：在PyCharm Terminal中执行pip show scrapy，看Location字段后拼上/scrapy/cmdline.py。
第三步：Parameters填crawl myspider，其中myspider是你spider.py里class定义的name = 'myspider'值，大小写和符号必须完全一致。
第四步：Working directory设为项目根目录——【即包含scrapy.cfg文件的那一层，不是spiders/子目录，也不是myproject/包目录】。填错会导致scrapy找不到配置，直接报错退出。
第五步：确认Python interpreter与安装Scrapy的环境一致——进入Settings → Project → Python Interpreter，检查列表中是否已显示scrapy。若无，需先在该解释器下执行pip install scrapy。
用main.py封装execute()（适合快速验证）
如果你只是临时调试、不想每次改配置，这个方法最快：在项目根目录（和scrapy.cfg同级）新建main.py，内容如下：
import os
import sys
from scrapy.cmdline import execute
sys.path.append(os.path.dirname(os.path.abspath(__file__)))
execute(['scrapy', 'crawl', 'myspider'])
注意：【必须有sys.path.append()这行，否则execute()无法导入项目内模块（如items.py、pipelines.py）】。写完后右键main.py → Debug 'main' 即可启动。
命令行终端直接运行（基础验证）
打开PyCharm内置Terminal，cd到项目根目录（含scrapy.cfg），执行：scrapy crawl myspider。
如果报command not found: scrapy，说明当前shell没识别scrapy命令——此时请改用python -m scrapy crawl myspider，它强制通过Python模块方式调用，绕过PATH查找。
如果报ImportError: No module named 'scrapy'，说明Terminal使用的Python解释器未安装Scrapy，需先激活对应虚拟环境或用pip install scrapy安装。
