搞了一下午才装好 Python？你可能踩了这 4 个坑

说实话，装 Python 这件事，我见过太多人卡在第一步就放弃了。

不是 Python 难，是安装过程里的小坑太多。下载错版本、环境变量没配好、命令行打不开……每个坑都能让你怀疑人生。

这篇文章就是帮你绕开这些坑的。10 分钟搞定，别像我当年一样折腾一下午。

Python 到底是什么？

Python 是一门编程语言。说人话就是：你写一堆英文指令，Python 帮你执行。

它长这样：

print("Hello World")

运行这行代码，屏幕上就会打印出 Hello World。

那 Python 能干什么？

• 写自动化脚本：批量改文件名、自动发邮件
• 做数据分析：pandas 一把梭处理 Excel
• 写网站后端：Django、Flask 了解一下
• 搞人工智能：现在最火的 AI 模型基本都用 Python

划重点：Python 是新手友好度最高的语言，没有之一。

第一步：下载 Python（别下错了！）

打开 python.org，点那个黄色的 Download Python 按钮。

⚠️ 这里有个坑：页面默认可能给你下最新版。新手建议用 3.10 或 3.11，太新的版本有些第三方库还没适配。我踩过这个坑，装了个 3.13，结果半天找不到能用的库。

Windows 用户注意：下载页面往下拉，能看到 Windows installer。一定要勾选 “Add Python to PATH”，这个复选框在安装界面最下面，很多人没注意就跳过了。

不勾的话，后面在命令行里敲 python 会提示"不是内部或外部命令"，然后你就得手动配环境变量。

Mac 用户直接用 Homebrew：

brew install python@3.11

装完验证一下：

python --version
# 输出：Python 3.11.x

能看到版本号就说明装好了。

第二步：选个编辑器

Python 自带了一个叫 IDLE 的编辑器，但说实话，不太行。

推荐 VS Code，免费、轻量、插件多。去 code.visualstudio.com 下载。

装完 VS Code 后，装一个 Python 插件。打开 VS Code → 左边那个方块图标（扩展）→ 搜 “Python” → 装 Microsoft 官方的那个。

装完插件后，VS Code 就能做这些事：

• 代码自动补全
• 报错红线提示
• 一键运行代码
• 调试断点

一个字：香。

第三步：写下你的第一行代码

打开 VS Code，新建一个文件，保存为 hello.py。

敲下这行：

print("Hello World")

怎么运行？两种方式：

方式一：终端运行

在 VS Code 里按 Ctrl + ` 打开终端，输入：

python hello.py

方式二：直接点播放按钮

装上 Python 插件后，右上角有个小三角 ▶，点了就能运行。

屏幕上出现 Hello World，恭喜你，Python 环境没问题。

新手最容易踩的 4 个坑

坑 1：分不清 Python 2 和 Python 3

现在已经没人用 Python 2 了。如果你看到教程里用 print "hello"（没括号），那是 Python 2 的写法，赶紧换个教程。

Python 3 里必须加括号：print("hello")。

坑 2：中文乱码

代码里有中文，运行报错 SyntaxError: Non-UTF-8 code。

解决方案：在文件第一行加上：

# -*- coding: utf-8 -*-

或者干脆在 VS Code 右下角把编码改成 UTF-8。

坑 3：缩进混用

Python 用缩进来表示代码块，不像其他语言用花括号 {}。

要么全用空格（推荐 4 个空格），要么全用 Tab。别混着用，否则 Python 直接报 IndentationError。

VS Code 默认帮你把 Tab 转成 4 个空格，所以用 VS Code 基本不会踩这个坑。

坑 4：不会读报错信息

新手看到满屏红字就慌了。其实报错信息是 Python 在帮你。

举个例：

Traceback (most recent call last):
  File "hello.py", line 3, in <module>
    prin("hello")
NameError: name 'prin' is not defined

关键看最后一行：NameError: name 'prin' is not defined。

意思是：第 3 行有个叫 prin 的东西，Python 不认识。哦，原来是 print 拼错了。

学会读报错，编程效率翻倍。

动手试试

1. 打印你的名字
2. 打印一句你喜欢的话
3. 故意把 print 拼错，看报错信息长什么样

参考答案：

print("张三")
print("Life is short, I use Python.")
printt("看看这个报错")  # 看看会报什么错

写在最后

环境搭建是最容易劝退的一步，但熬过去就好了。

说实话，后面写代码反而比装环境简单。因为代码是逻辑，错了能改。环境问题是玄学，有时候重装都不知道为什么突然就好了。

下一篇聊聊变量——你代码里的"收纳盒"。为什么要用变量、怎么起名不让人笑话、以及 Python 里到底有几种数据类型。

有问题评论区见，看到就回。