我见过太多零基础的人，学Python的第一天就放弃了。不是因为语法看不懂，也不是因为逻辑绕不过来，而是卡在环境搭建上——下载完安装包、双击、下一步、下一步，满怀期待地打开终端敲下一行python，结果屏幕甩回来一句“不是内部或外部命令，也不是可运行的程序或批处理文件”。很多人这一刻心态就崩了：完了，我可能真不适合学编程。其实你只是安装时漏勾了一个选项而已。
这篇文章就来解决这件事：从一台没装过任何开发工具的电脑开始，把Python环境完整搭起来，然后运行你人生中的第一个Python程序。整个过程不需要任何编程基础，照着做就行，但我也会把每一步背后的原理讲清楚，免得你照猫画虎装好了，第二天换个电脑又卡住。无论你是只想试试Python，还是准备以后学机器学习课程、开发网站，这套地基都是通用的。
1. 为什么第一课必须卡在“环境”这道门槛上
很多人觉得环境搭建就是个下载安装的体力活，没什么含金量，所以特别容易轻视。但恰恰是这件“没含金量”的事，卡住了至少一半的新手。原因很简单：环境搭建涉及的术语——解释器、环境变量、终端、编辑器——单独拎出来每个都不难，但混在一起，初学者就懵了。
1.1 一套能运行Python的环境，最少需要哪几样东西
先说结论：要运行Python程序，最少只需要一个东西——Python解释器。它负责把你写的代码翻译成计算机能执行的操作。生活中可以大致类比成一个翻译官：你用Python语言写了一封“信”，翻译官读完后，用机器听得懂的方式去执行，然后把结果传回来。
除了解释器，你还需要一个写代码的地方，也就是编辑器。如果你够狠，用系统自带的记事本也能写Python代码，保存的时候把后缀改成.py就行。但实际工作中没人会这么干，因为记事本没有语法高亮、没有自动补全、也没有一键运行。编辑器这件事，我后面专门用一个章节来讲，这里先知道你需要它即可。
还有一个容易被忽略但非常重要的东西：终端（终端窗口）。Windows上叫命令提示符（cmd）或PowerShell，macOS和Linux上叫终端（Terminal）。你运行Python程序、用pip安装第三方库、启动虚拟环境，全部都要在终端里敲命令。很多新手把终端当成一个很吓人的黑色窗口，其实它就是给你输入命令、查看输出结果的地方，跟聊天软件的输入框没有本质区别。
所以一套完整的Python学习环境 = Python解释器 + 编辑器 + 终端。三样东西各管各的，理解了这一点，后面所有报错你都能自己分析个大概。
1.2 版本选择：认准官方最新稳定版，其他都别碰
打开浏览器搜索Python，你会看到五花八门的下载源：有带“中文”字样的第三方网站，有各种一键安装包，还有一堆广告推广的“Python环境管理工具箱”。我的建议只有一条：去官网python.org，下载页面里的最新稳定版。其他来源，尤其是来路不明的一键安装包，真的别碰。
版本具体怎么选？现在Python 2已经彻底停止维护，所有教程、库和项目都在Python 3上，所以认准Python 3就行。下载页面一般会同时提供多个版本，比如Python 3.12、Python 3.13，选数字最大的稳定版即可，不要选带rc、beta、alpha字样的预览版。原因很现实：预览版可能有不兼容的改动，你在上面遇到的问题，搜索引擎都未必搜得到答案，新手根本没法排错。稳定版用户基数大，任何奇怪报错都早有人踩过，查资料效率完全不一样。
至于32位还是64位，绝大多数人是64位系统，直接选64位安装包。除非你的电脑确实很老，否则不用动脑子。
1.3 装完之后，你的电脑里会多出什么
安装过程本身很简单，但很多新手装完不知道自己到底装了些什么，所以我来拆一下。装完Python之后，你的电脑里至少会多出这几样东西：
- Python解释器本体：核心程序，用来执行
.py文件。 - Python标准库：一个巨大的、自带的功能模块集合，比如处理文件、日期、数学运算等，装完就能用。
- pip：Python的包管理工具，负责下载和安装第三方库，可以理解成Python官方的“应用商店”。后面装numpy、django、pytorch等库时全得靠它。
- IDLE：Python自带的一个极简编辑器/交互环境，适合应急，但不适合长期使用。
这里尤其要记住pip。很多学Python的人学到后面要装第三方库，在终端输入pip install xxx，结果系统提示“pip不是内部或外部命令”，整个人当场傻掉。其实pip很少是真的没装，大多数情况是环境变量没配置好，导致终端找不到它。后面我会专门讲这个问题的解法，这里先留个印象：Python解释器、pip、编辑器，三者是三个独立的东西，安装Python只是给你提供了前两个，编辑器需要另外准备。
2. 分系统安装实操：照着点鼠标就能完成
环境搭建这种操作，光讲理论没用，必须给出一套能直接照着做的方法。这一部分我按Windows、macOS、Linux三个系统分开讲，每个系统都有自己的关键点，尤其是Windows，那个勾选框直接决定了你后面会不会踩坑。
2.1 Windows用户最该记住的一个勾选框
Windows是新手最多、坑也最多的系统，但解决办法其实特别机械。
第一步，打开python.org/downloads，页面会自动识别你的操作系统，显示一个黄色大按钮，写着“Download Python 3.x.x”，直接点击下载。下载完成后双击运行安装包。
第二步是关键中的关键：安装界面第一屏的最下方，有一个“Add Python to PATH”的可选框，必须打勾。这个选项的意思是，把Python的安装目录加入系统的环境变量PATH里，这样你在任意目录打开终端输入python，系统都能找到它。很多人的“python不是内部或外部命令”报错，就是漏了这一下。
打勾之后，我建议你点“Customize installation”而不直接点“Install Now”。点进去后一路保持默认勾选，直到出现“Advanced Options”页面，这个页面里记得确认几个选项都是勾上的，比如“Install for all users”，然后选择一个安装路径。如果只是自己学习，默认路径完全可以；但如果你机器上装过其他版本的Python，最好手动把路径改成一个你能认出来的目录，方便以后找。
安装完成后，按Win + R，输入cmd，回车，打开命令提示符，依次输入这两条命令：
python --version pip --version如果屏幕上分别打印出类似Python 3.13.1和pip 25.x from ...的信息，恭喜你，Windows上的Python环境就通了。如果出现“不是内部或外部命令”，先别慌，去本文第5节找对应解法。
这里有个小提醒：每次装完Python后，之前已经打开的命令提示符窗口里是看不到新环境变量的，需要重新开一个窗口才能生效。很多人明明装好了，却在一个旧窗口里反复试，白白怀疑人生。
2.2 macOS：官网安装包与Homebrew两种走法
macOS用户有一个误区，觉得macOS自带了Python，不用装。实际上macOS自带的那个Python 2（某些旧版本系统里）或“Command Line Tools”里的Python，和你要用的开发环境是两回事。而且系统组件可能依赖着自带的Python，你最好别去动它。正确做法是再装一份独立的、属于你自己项目的Python。
先说我更推荐新手的方法：去python.org/downloads下载macOS的安装包，文件是.pkg格式，双击运行，按提示输入你的用户密码，一路“继续”直到装完。装完后打开终端（快捷键Command + 空格，输入“终端”回车），输入：
python3 --version这里注意，macOS上通常要输入python3而不是python。因为系统里旧版本用的是python这个名字，为了避免冲突，官方安装的Python 3注册为python3命令。只要能打印出版本号，就说明装好了。
另一种方式是使用Homebrew包管理器，命令是brew install python。熟悉命令行的老手用起来很舒服，版本管理也方便，但Homebrew本身也需要安装，对完全零基础的朋友来说多了一层学习负担。所以我的建议是：新手先用官网安装包，等你用了一两个月，对终端和版本的概念都比较熟悉了，再去折腾Homebrew也不迟。
macOS用户偶尔会遇到一个问题：打开终端输入python3，系统弹窗提示“需要安装命令行开发者工具”。这是正常现象，直接点“安装”，等它下载完就行。如果网络环境不佳导致安装失败，那就选择从官网.pkg包安装，一般能绕开这一步。
2.3 Linux：系统已经带了Python，但要会分“系统版本”和“项目版本”
Linux发行版很多，不同发行版包管理命令不一样，这里以最常见的Ubuntu/Debian系为例。
Ubuntu系统默认自带Python 3，但版本可能偏旧，而且系统的很多工具依赖它。新手最容易犯的错误是：手贱把系统自带的Python卸载了，或者用某个升级脚本把它换成了全新版本，结果系统直接起不来。这句话我不是吓唬人，是真的会让桌面环境崩溃。
正确做法是，用包管理器再装一份完整的开发环境：
sudo apt update sudo apt install python3 python3-pip python3-venv然后验证：
python3 --version pip3 --version在Linux上，命令也是python3和pip3，原因和macOS一样，避免和系统自带版本混淆。如果你用的不是Debian系，比如Fedora、Arch这些，包管理器对应换成dnf、pacman即可，本质逻辑一样。
如果装完发现版本还是太旧，别急着动系统Python，我建议等学习到中后期再引入pyenv这样的版本管理工具。pyenv能让你在用户目录下安装各种Python版本，并且按项目切换，完全不碰系统自带的版本，安全得多。但第一课我不展开它，免得信息过载，这里只需要记住“不要动系统Python”这条底线。
2.4 三系统统一的“环境体检”三步
装完之后，不管什么系统，我都建议做一个三步体检，确认环境真的没问题：
- 检查解释器版本：Windows输入
python --version，macOS/Linux输入python3 --version。 - 检查pip：Windows输入
pip --version，macOS/Linux输入pip3 --version。 - 进入交互模式：在终端输入
python或python3，回车，看到>>>提示符后，输入print("hello")，再回车，如果能输出hello，说明整个链路的“输入命令 → 解释器执行 → 输出结果”完全正常。
第三步行完，按Ctrl + D（macOS/Linux）或exit()（Windows）退出交互模式，回 到普通终端。到这里，你的环境搭建就算正式完成了。接下来就是选编辑器、写第一个正经程序。
3. 编辑器选型：别在第一步就把自己劝退
解释器装好后，很多人会问：我该用哪个编辑器？这个问题像“哪个手机系统最好用”一样容易引发争论，但作为第一课，我的答案很明确：不要在这件事上花超过半个小时做选择。
3.1 为什么我不建议新手第一周就装全量IDE
先说说IDE这个概念。IDE，全称集成开发环境，就是把编辑器、调试器、终端、项目管理等一堆工具打包到一起的软件。PyCharm就是最典型的Python IDE。
PyCharm功能确实很全，但我几乎没见过零基础新手用它顺利度过前两周。原因不是它不好，而是它太“重”：一打开就是几十个按钮，新建一个项目要选环境、选解释器，各种弹窗提示，字面意义上的“还没开始写代码，就被界面吓退了”。而且PyCharm的专业版是要收费的，社区版虽然免费但功能也砍了一些。
你学编程的前三周，90%的操作其实就是：新建一个.py文件、写十来行代码、点一下运行、看输出。这些需求，一个轻量编辑器完全够用，而且没有多余干扰。所以我给新手的建议是：这个阶段用VSCode就够了，它是现在社区最主流的编辑器，免费、跨平台、后续学任何语言都能用上，不会浪费你学会它的时间。
如果你的操作系统比较老、或者你就是想用最少的配置先跑起来，那直接用Python自带的IDLE也行，它长得很简陋，但新建文件和运行程序零配置，几乎没有门槛。我用VSCode做下面的示例，因为它顺便能帮你把“终端”“解释器”“插件”这些概念串起来。
3.2 15分钟跑通VSCode：插件、解释器、运行按钮
去code.visualstudio.com下载安装VSCode，安装时建议把“添加到PATH”和“在文件资源管理器上下文菜单中显示‘通过Code打开’”这几个选项都勾上，方便以后右键直接打开文件夹。
装好后，按Ctrl + Shift + X打开扩展商店，搜索“Python”，安装微软官方发布的那个Python扩展（发布者显示为Microsoft）。装完后，VSCode会提示你Reload窗口（重新加载窗口），点一下让它生效。
然后新建一个文件夹，比如叫python-first-lesson，用VSCode打开这个文件夹（文件 → 打开文件夹，或者右键文件夹 → 通过Code打开）。新建文件，命名为hello.py，写下一行代码：
print("你好，Python！")按Ctrl + S保存，然后点击右上角的三角形运行按钮。第一次运行，如果右下角弹出提示“Select Python Interpreter”（选择Python解释器），点它，选择你之前安装的那个Python版本即可。如果没有弹窗，也可以通过命令面板操作：按Ctrl + Shift + P，输入“Python: Select Interpreter”，回车，选择解释器。
VSCode装完Python扩展后，运行按钮的本质其实是在终端里帮你执行了python hello.py或python3 hello.py这条命令，然后把输出显示在下面。这个认知非常有用，因为它解释了为什么有时候代码在VSCode里能运行、在终端里却报错——你需要在不同工具间切换时，最终都能找到同一个Python解释器。
3.3 虚拟环境：现在不用懂，但建议留个印象
我在前面提到“以后学机器学习课程”“以后装PyTorch”，这些场景里一定会遇到一个词：虚拟环境。虚拟环境是什么？一句话版本：给每个项目单独隔离出一套第三方库环境，避免项目A需要的库版本和项目B冲突。
举一个真实例子：你有一个旧项目用了Django 3.2，新项目要用Django 5.0，如果你把所有库都装在全局环境里，那旧项目很可能就起不来了。虚拟环境就是给每个项目一个独立的小房间，各装各的版本，互不打扰。
第一课你不需要完全理解它，甚至不需要真的去用，但至少把创建虚拟环境的三条命令记下来，因为以后几乎每个正式项目都会用到：
首先，在项目目录下打开终端（VSCode顶部菜单：终端 → 新建终端），执行：
python -m venv venv（macOS/Linux用python3 -m venv venv，下同。）
然后激活虚拟环境：
- Windows：
venv\Scripts\activate - macOS/Linux：
source venv/bin/activate
激活后，终端的命令提示符前面会出现(venv)字样，表示现在处于这个虚拟环境内，之后执行的pip install都会装到这个环境里。要退出时，输入deactivate即可。
为什么第一课就告诉你这个？因为等到真正需要的时候再学，大概率会手忙脚乱，而现在留个印象，将来接触时不会觉得陌生。我自己教过的一个学员，后来装机器学习环境时卡了一下午，最后发现根因就是他所有库都装在了全局环境，版本冲突把pytorch搞得支离破碎。虚拟环境不是进阶知识，而是保命常识。
4. 第一个程序“你好，Python”的正确打开方式
环境搭完了、编辑器也选好了，现在可以堂堂正正写第一个程序了。但“第一个程序”这种事，看起来简单，里面也藏着不少新手容易忽略的细节，我一个个说。
4.1 同一句print，两种运行姿势
Python里最经典的入门函数是print()，作用是把括号里的内容输出到屏幕上。同样是这句代码，有两种不同的运行方式。
第一种是交互模式。在终端输入python或python3，进入>>>提示符，然后直接输入：
print("你好，Python！")回车，立刻就能看到输出。这种模式的好处是即时反馈，适合试一小段代码，比如计算1 + 1、看看某个函数怎么用。缺点是代码不会被保存，关了窗口就没了。
第二种是脚本模式。把代码写进一个.py文件，保存，再通过终端执行python hello.py。这种方式是写真正项目的常态：代码可以保存、修改、反复运行，也方便别人接手。
对初学者，我强烈建议从一开始就养成“写文件 → 运行”的习惯，而不是老在交互模式里试。原因是交互模式容易让你忽略文件路径、执行入口这些非常重要的概念，等你后面要跑一个1000行的项目时，还是得回到文件执行模式。用生活化的比喻：交互模式像当面聊天，说一句回一句；脚本模式像写信寄出去，内容完整、有记录、能被多次阅读。
4.2 新手必踩的“中英文符号”与路径小坑
写第一行代码时有几个特别容易翻车的地方，几乎每个零基础学员都中过招。
第一是括号和引号的半角/全角问题。Python里所有符号都必须是英文半角括号()和英文半角引号"或'。如果你在中文输入法状态下打出print（"你好"），Python会直接给你一个SyntaxError: invalid character '（' (U+FF08)之类的报错。解决办法不是把输入法切来切去，而是记住：写代码时，代码里的标点符号全部用英文，只有字符串内容里可以出现中文。
第二是文件命名。保存.py文件时，文件名尽量不要用中文，也不要带空格，比如写成hello.py就行。另外特别提醒：别把文件起成random.py、json.py、math.py这种和Python标准库同名的名字。因为Python在你导入某个模块时，会先看当前目录有没有同名文件。如果你有个random.py，再写import random，导入的很可能就是你自己的文件，而不是Python内置的random库，程序行为会非常诡异。
第三是中文输出乱码问题。现在的Python 3默认UTF-8编码，绝大多数情况下中文输出没问题。如果偶尔在旧版Windows控制台上看到乱码，优先把终端字体改成“TrueType字体”，或者把代码文件用UTF-8编码保存。尽量不要在代码顶部硬性加# -*- coding: utf-8 -*-，这行注释在Python 3里已经没必要了。
4.3 学会看报错，比学会抄代码更重要
第一次写程序的人，最怕的就是看到红色的报错信息。但我必须说一句反直觉的话：报错是你学编程时最好的老师，学会读报错，你的自学效率会提升十倍。
带你读一次报错。比如你在文件里写了：
print("你好，Python！"少打了一个右括号，运行后终端会出现类似这样的信息：
File "hello.py", line 1 print("你好，Python！" ^ SyntaxError: '(' was never closed怎么看？第一行File "hello.py", line 1告诉你出错的文件是hello.py，位置是第1行；第二行把出错的那行代码原样贴出来；最后一行SyntaxError是错误类型，后面是解释——“这个左括号从未被闭合”。所以，它的意思就是：你的代码少了一个右括号。
新手最容易犯的错误是看报错时从第一行看到最后一行，越看越慌。正确姿势是：从最后一行开始看，先看错误类型，再回头看是哪个文件哪一行，最后对照代码逐个排查。刚学Python时，常见错误就那么几个：
SyntaxError：语法错误，通常是括号、引号、缩进的问题。NameError：名字错误，通常是你用了没定义过的变量或函数。IndentationError：缩进错误，Python用缩进表示代码块，缩进不对就会报这个。TypeError：类型错误，比如让字符串和数字直接加起来了。
这几种错误以后几乎天天见。现在你只需要形成一个观念：报错不是天塌了，它是程序在告诉你“我哪儿不舒服”，而且它已经尽量告诉你了。
5. 环境搭建高频报错排查：从“不是内部或外部命令”说起
这一节是很多人真正需要的部分。前面安装教程写得再详细，也会有人遇到各种意外问题。我挑几个最高频的报错，按排查思路讲，你看完自己就能解决一半的环境问题。
5.1 谁在喊“python不是内部或外部命令”
在Windows上，安装完Python后输入python，如果系统回你一句：
'python' 不是内部或外部命令，也不是可运行的程序或批处理文件。或者在PowerShell里是：
python : 无法将“python”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。这两种说法本质上是同一件事：系统在你的“可执行文件搜索路径”里找不到名为python.exe的程序。而那个“搜索路径”，就是安装时提到的PATH环境变量。
解决办法有两个。第一个也是最省事的：重新运行Python安装包，选“Modify”，在“Optional Features”和“Advanced Options”页面确认“Add Python to environment PATH”是勾上的，然后继续完成安装。装完后一定要重新打开一个终端窗口再试。
第二个办法是手动改PATH。右键“此电脑”→ 属性 → 高级系统设置 → 环境变量，在“系统变量”里找到Path，双击编辑，把Python安装目录和它的Scripts子目录都加进去（比如C:\Users\你的用户名\AppData\Local\Programs\Python\Python313\和...\Python313\Scripts\）。这一步操作起来比文字描述的略麻烦，但只要仔细定位，不难。我建议实在不想重装的人才这样干，新手优先用第一种方法。
5.2 pip找不到怎么办，以及python -m pip的妙用
pip报“不是内部或外部命令”，原因和上面基本一样，也是PATH问题。但这里我要教一个更加一劳永逸的技巧：用python -m pip代替裸的pip。
python -m pip install xxx的含义是：先明确指定用哪个Python，再运行这个Python里的pip模块。它不依赖PATH里有没有pip的快捷命令，所以只要python本身能用，pip就一定能用。比如：
python -m pip install requests把pip install替换成python -m pip install后，基本可以绕开所有“pip不是内部或外部命令”的烦恼。macOS/Linux用户对应写python3 -m pip install xxx。
另外，Windows用户判断自己Python环境是否正常，还有一个利器叫py：
py --version py -m pip --versionpy是Windows官方Python安装器自带的启动器命令，比python更稳，遇到多版本切换问题时也很有用。不过第一课你只需要知道它的存在，真要被版本问题逼到墙角时，它会是个救兵。
5.3 在VSCode里运行失败，十有八九是解释器没选
环境本身没问题，但VSCode里点运行按钮却报错，最常见的情况是：VSCode的Python扩展没有正确选择解释器。
典型报错是：
No Python interpreter selected或者：
spawn python ENOENT前者意思是“没有选择Python解释器”，后者意思是“系统找不到python这个程序来启动”。
解决办法就是重新指定解释器：Ctrl + Shift + P→ 输入Python: Select Interpreter→ 回车 → 在所有候选列表里选你刚安装的那个版本（路径里通常能看到python.exe或python3）。选完后，VSCode底部的状态栏会显示你选择的Python版本。如果还是没有，把VSCode的窗口完全关掉重新打开一次，让插件重新初始化。别小看这个“重启一下”的土办法，很多扩展配置不生效，重启一次就正常了。
另一个常见场景：你在VSCode里运行没问题，但自己打开终端运行同样一个文件却报错。这大概率就是工作目录问题。VSCode的运行按钮默认会在当前打开文件夹的根目录执行命令，而你自己在终端里可能已经cd到了别的目录。解决方式是在终端里先cd回项目目录，或者右键点击你的.py文件选择“在终端中运行 Python 文件”。
5.4 电脑上装了多个Python，怎么确认当前用的是哪个
很多人电脑上不止一个Python：可能装过Anaconda、从官网装过Python、又用Microsoft Store装过Python。这种情况下，你在终端输入python时，系统找到的可能是任意一个，于是经常出现“我明明装了Python 3.12，为什么运行还是3.10”这种怪事。
排查方法很简单。Windows输入：
where pythonmacOS/Linux输入：
which python3系统会把当前PATH中找到的python路径列出来。列出的第一个，就是你敲python时真正运行的那个。如果列出来好几个，你就明白了：问题不在于Python没装，而在于你用的python到底指向哪个安装目录。
多版本并存本身不是问题，但对新手来说，它让pip安装的库很容易装到“另一个Python”里去，到时候import numpy报错，你根本说不清是哪个环境在import。所以我的建议是：新手阶段尽量把不需要的Python卸载掉，只保留一个官网安装的稳定版。如果你确实需要Anaconda跑数据科学项目，那也至少等熟悉了虚拟环境的概念之后再说。
另外提醒一下“python还是python3”这个老大难问题。Windows上通常用python，macOS/Linux上通常用python3。这不是哪个对哪个错的问题，而是系统为了兼容旧版本保留的命令别名差异。只要你记得“用哪个Python看哪个命令”，就不会在这种问题上内耗。
我教Python这几年，发现一个规律：环境能顺利搭好的人，后面学下去的概率大很多。不是因为环境搭建锻炼了什么能力，而是它带来的正反馈——你能亲眼看到自己写的代码被电脑执行、看到输出出现在屏幕上——会形成“我能搞定工具问题”的信心。这份信心，比多背几个语法点珍贵得多。
所以你学完这一课后，可以给自己留个小任务：别只满足于print一句话，试着在变量里存一个名字，再打印出来，或者打印一下今天的日期。遇到问题就拆开看，是语法问题还是环境问题，想不明白再查一遍这一课的内容。环境搭建再好，也只意味着你站在了起跑线上，真正有趣的东西，在后面等着你。
