我见过太多零基础的人学Python的第一天就放弃了。不是因为语法看不懂也不是因为逻辑绕不过来而是卡在环境搭建上——下载完安装包、双击、下一步、下一步满怀期待地打开终端敲下一行python结果屏幕甩回来一句“不是内部或外部命令也不是可运行的程序或批处理文件”。很多人这一刻心态就崩了完了我可能真不适合学编程。其实你只是安装时漏勾了一个选项而已。这篇文章就来解决这件事从一台没装过任何开发工具的电脑开始把Python环境完整搭起来然后运行你人生中的第一个Python程序。整个过程不需要任何编程基础照着做就行但我也会把每一步背后的原理讲清楚免得你照猫画虎装好了第二天换个电脑又卡住。无论你是只想试试Python还是准备以后学机器学习课程、开发网站这套地基都是通用的。1. 为什么第一课必须卡在“环境”这道门槛上很多人觉得环境搭建就是个下载安装的体力活没什么含金量所以特别容易轻视。但恰恰是这件“没含金量”的事卡住了至少一半的新手。原因很简单环境搭建涉及的术语——解释器、环境变量、终端、编辑器——单独拎出来每个都不难但混在一起初学者就懵了。1.1 一套能运行Python的环境最少需要哪几样东西先说结论要运行Python程序最少只需要一个东西——Python解释器。它负责把你写的代码翻译成计算机能执行的操作。生活中可以大致类比成一个翻译官你用Python语言写了一封“信”翻译官读完后用机器听得懂的方式去执行然后把结果传回来。除了解释器你还需要一个写代码的地方也就是编辑器。如果你够狠用系统自带的记事本也能写Python代码保存的时候把后缀改成.py就行。但实际工作中没人会这么干因为记事本没有语法高亮、没有自动补全、也没有一键运行。编辑器这件事我后面专门用一个章节来讲这里先知道你需要它即可。还有一个容易被忽略但非常重要的东西终端终端窗口。Windows上叫命令提示符cmd或PowerShellmacOS和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标准库一个巨大的、自带的功能模块集合比如处理文件、日期、数学运算等装完就能用。pipPython的包管理工具负责下载和安装第三方库可以理解成Python官方的“应用商店”。后面装numpy、django、pytorch等库时全得靠它。IDLEPython自带的一个极简编辑器/交互环境适合应急但不适合长期使用。这里尤其要记住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 --versionmacOS/Linux输入python3 --version。检查pipWindows输入pip --versionmacOS/Linux输入pip3 --version。进入交互模式在终端输入python或python3回车看到提示符后输入print(hello)再回车如果能输出hello说明整个链路的“输入命令 → 解释器执行 → 输出结果”完全正常。第三步行完按Ctrl DmacOS/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 venvmacOS/Linux用python3 -m venv venv下同。然后激活虚拟环境Windowsvenv\Scripts\activatemacOS/Linuxsource 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 (UFF08)之类的报错。解决办法不是把输入法切来切去而是记住写代码时代码里的标点符号全部用英文只有字符串内容里可以出现中文。第二是文件命名。保存.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环境是否正常还有一个利器叫pypy --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上通常用pythonmacOS/Linux上通常用python3。这不是哪个对哪个错的问题而是系统为了兼容旧版本保留的命令别名差异。只要你记得“用哪个Python看哪个命令”就不会在这种问题上内耗。我教Python这几年发现一个规律环境能顺利搭好的人后面学下去的概率大很多。不是因为环境搭建锻炼了什么能力而是它带来的正反馈——你能亲眼看到自己写的代码被电脑执行、看到输出出现在屏幕上——会形成“我能搞定工具问题”的信心。这份信心比多背几个语法点珍贵得多。所以你学完这一课后可以给自己留个小任务别只满足于print一句话试着在变量里存一个名字再打印出来或者打印一下今天的日期。遇到问题就拆开看是语法问题还是环境问题想不明白再查一遍这一课的内容。环境搭建再好也只意味着你站在了起跑线上真正有趣的东西在后面等着你。