盯着终端里那一行鲜红的报错信息，你是不是也想过干脆把电脑砸了？别急，python脚本学习路上谁没踩过几个坑。后台经常收到这样的留言：“代码明明照着教程敲的，怎么一跑就报错？”今天咱们不扯虚的，直接说三个最容易出问题的地方，挨个排查，十有八九能解决。

先别急着复制网上的代码，这步你大概率漏了

　　很多人拿到一个python脚本，第一反应就是复制粘贴然后按回车。结果控制台刷出一堆红字，心态直接崩了。其实80%的报错跟环境有关。先确认你当前用的是哪个Python解释器：打开终端，输python --version或者python3 --version，看看版本对不对。有些教程默认Python3，你系统里却绑着Python2，那语法肯定不兼容。还有虚拟环境没激活？pip安装的包装到了全局？这些细节一个不对，脚本就跑不通。

　　别慌。

　　第二步检查缩进。Python对缩进敏感到变态，混用空格和Tab会直接报IndentationError。有的朋友可能遇到过：代码逻辑看着没问题，但一运行就提示unexpected indent。把编辑器里显示空格和Tab的选项打开，一眼就能看出毛病。另外，多行字符串或括号没闭合也会导致缩进异常，顺手看看行尾有没有少个引号。

　　第三步看依赖。很多python脚本会引用第三方库，比如requests、pandas之类。如果你没装，或者装错了版本，就会报ModuleNotFoundError。建议在项目目录下建一个requirements.txt，然后用pip install -r一键装。要是还报错，检查一下是不是系统里装了多个Python版本，pip install装到了另一个解释器上。用pip list看看已安装的包，跟你脚本里import的对不对得上。

　　以上三点排查完，90%的脚本跑不通问题都能解决。剩下的可能是网络请求超时、文件路径写死等，那就得具体看报错信息了。记住：报错不是末日，它是在告诉你哪里出了问题。去终端试一下，不行再翻官方文档——那玩意儿最准。

依赖安装总失败？换个思路试试

　　这算python脚本学习里的高频坑了。明明输pip install xxx，结果提示连接超时、权限不足、或者版本冲突。别硬怼，先换国内镜像源：临时用pip install xxx -i https://pypi.tuna.tsinghua.edu.cn/simple，或者永久修改配置文件。如果是权限问题，别一上来就sudo，试试加--user参数。要是版本冲突，用虚拟环境隔离：python3 -m venv venv，然后source activate，再装依赖，保准清爽。

　　环境变量也是隐形杀手。有时候你明明装了包，脚本还是找不到，十有八九是PATH没设对。Windows用户检查系统环境变量里有没有Python和Scripts目录，macOS/Linux看看~/.zshrc或~/.bashrc里有没有export PATH。顺手检查一下PYTHONPATH，别被自己设置的奇怪路径坑了。

　　问题都解决了？那就继续写代码，别在这耗着。如果还是卡住，去Stack Overflow搜那个报错信息，比问我靠谱多了。