☰
Python零基础入门:安装、环境配置与核心概念详解
2026/10/5 13:54:39 网站建设 项目流程

很多想学Python的人,第一周就放弃了。

不是Python难,而是他们被安装环境、编辑器配置、各种报错劝退了。我见过太多人卡在“python不是内部或外部命令”,卡在“python was not found”,卡在装了一堆软件却不知道在哪写代码。说实话,这些都算不上真正的编程问题,只要有人把这些坑提前讲一遍,99%的人根本不会掉进去。

这篇文章就是来解决这些问题的。我把它定位成Python学习系列的第一篇,只做一件事:帮你把地基打牢。内容包括Python的安装、解释器到底是个什么东西、写代码前必须搞清楚的几个核心概念、还有新手最常见的报错和误区。适合完全零基础的人,也适合之前学过、但一直没搞明白环境是怎么回事的人。

先把“能不能跑起来”这件事解决,再谈后面那些炫酷的爬虫、数据分析、人工智能。地基不牢,后面全是空中楼阁。

1. 先搞清楚Python是什么、怎么运行,再动手安装

很多教程上来就让你装软件、敲代码,却不说清楚Python本身是个什么东西。结果就是,你照着敲了一下午代码,却完全不知道发生了什么,一旦报错就彻底傻眼。

1.1 解释器和代码的关系:不需要理解底层,但要有正确的直觉

Python本质上是一门编程语言——它是给人看的规则。而真正在电脑上把代码“翻译”成机器能理解的指令、然后逐条执行的,是一个叫“解释器”的程序。

打个比方:你写的Python代码就像一份中文菜谱,解释器就是那位照着菜谱做菜的厨师。你告诉厨师“print("你好")”,他做完之后把菜端出来——这个端出来的过程,就是屏幕上显示的那句话。

所以“安装Python”,安装的最核心东西就是那个解释器。你写的每一条代码,最终都会交给它来执行。搞清楚这一点,你就不会犯“我下载了代码文件为什么运行不了”这种错误——因为你下载的只是菜谱,你还需要一个厨师。

1.2 Python 2和Python 3:认准版本,不要走到老路上

如果你在网上搜资料,可能会翻到一些十几年前的老教程,里面写着Python 2的语法。

直接告诉你结论:学Python 3。现在无论用什么教材、什么工具,安装的时候都认准Python 3.x(比如3.10、3.11、3.12,越新越好)。Python 2在2020年已经停止维护,语法上有不少差异,你学了它等于白学。除非你要维护的是公司里的远古遗产项目,否则完全不建议碰。

1.3 一行代码是怎么跑起来的

在你安装好Python之后,运行代码有两种方式:

第一种,交互式运行。你打开终端,输入python回车,进入一个>>>的界面,在那里面输入一行代码,它立刻执行、立刻出结果。适合做小实验、试个函数用途。

第二种,脚本式运行。你把代码写进一个以.py结尾的文件里,然后通过python 文件名.py这个命令一次性执行整个文件。这是正式写程序的方式。

我特别想给新手强调一个直觉:Python是逐行解释执行的,不是像C++那样需要先编译成整个可执行文件。所以你在交互式里敲一行的运行结果,和你写进脚本里运行的结果,原则上是等价的。很多初学者理解不了这两个模式的区别,后面前后对不上,到处怀疑是不是自己代码错了,其实是运行方式的差异。

2. 安装这一步为何劝退最多人:python wasn't found 究竟错在哪

这个热搜词排得非常靠前:python was not found; run without arguments to install from the microsoft store。我可以负责任地说,这是Windows用户最常碰到的报错之一。它不是在说你的代码有问题,而是你的系统压根没找到名叫python的命令。

2.1 Windows安装全流程:别跳过关键选项

在Windows上装Python,我的建议是直接去官网python.org,下载最新稳定版。下载的时候注意选Windows installer(64-bit),不要选成网页版或者源码包。

安装时有一个坑,90%的人都踩过:安装向导第一屏底部有一个Add Python to PATH的选项,默认是不勾的,你必须手动勾上。

很多人会问:PATH是什么?为什么要勾?

我打个比方:PATH就是Windows给所有可执行程序准备的一个“通讯录”。你在命令行里输入python,Windows就会翻这个通讯录,找到python.exe在哪,然后启动它。如果你没把Python加进通讯录,Windows翻遍通讯录也找不到,只能报“python not found”。就这么简单。

安装完成后怎么验证?按Win + R,输入cmd回车,在弹出的黑窗口里输入:

python --version

如果显示Python 3.12.x这类信息,恭喜你,安装成功了。如果没有,先检查是不是忘了勾PATH。忘了的话,卸载重装一次,或者去系统环境变量里手动把Python的安装目录加进Path里,路径一般是C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\和它下面的Scripts文件夹。

2.2 那个著名的Microsoft Store报错是怎么来的

当系统找不到python命令,而你又刚好在命令行里输入了python,Windows 10/11有一个很“贴心”的功能:它会自动弹出提示,问你要不要从Microsoft Store安装。

这就是那句python was not found; run without arguments to install from the microsoft store的来源。它本身不是一个错误信息,而是一个系统提示。

但很多人想不通:为什么我从官网装了Python,还是会碰到这个提示?

大概率是两种情况:

  • 安装时没勾PATH,导致命令行的通讯录里查无此人,系统只能走默认的Store引导;
  • 或者你打开了新的命令行窗口,但PATH变化还没生效——Windows的PATH在你修改后,已经打开的命令行窗口是感知不到的,必须新开一个窗口。

解决办法就是把Python正确加入PATH,然后新开一个cmd窗口再试。顺便说一句,有些人图省事从Microsoft Store安装Python,也不是不行,但路径有时比较特殊,容易在后续装第三方包的时候出幺蛾子。我更推荐官网下载装。

2.3 Mac和Linux:系统自带的Python要分清

Mac电脑默认自带Python 2(老版本系统)或者没有预装(新版本系统),Linux大多数发行版也自带Python 3。但这不意味着你可以直接使用——系统自带的Python往往是给系统工具用的,随意改装真的能把系统搞挂。

Mac上装Python,我的建议是装Homebrew,然后:

brew install python

Linux上则要看你的发行版。Ubuntu和Debian系的:

sudo apt update sudo apt install python3 python3-pip

安装完成后,在Mac和Linux上验证命令不太一样:

python3 --version

为什么不是python?因为很多系统内部脚本依赖的是老版本Python,如果你把python命令绑定到新版本上,可能引发连锁反应。所以Linux发行版普遍用python3来指代Python 3。你在Windows上习惯敲python,到了Linux上可能要改成python3,这是环境差异,不是你的问题。

2.4 卸载Python也有讲究

热搜里有“卸载python”这个词,说明不少人不小心装坏了,或者装了两个版本搞乱了。我的建议是:如果只是版本不合适,不要急着卸载,因为卸载后依赖它的其他工具可能一起出问题。你可以保留旧的,再装新的,用命令行指定用哪个版本执行。

如果真的需要卸载,去Windows的“设置”->“应用”里找到Python,点击卸载即可。卸载完别忘了去环境变量里检查是否残留了旧的PATH路径,否则以后命令行可能还会提示一些奇怪的东西。

2.5 pip和国内源:装完Python后一定会用到的基础设施

装完Python之后,你大概率要通过pip安装第三方库(比如后面要用的requests、pandas、matplotlib)。这个pip是Python官方的包管理工具,装Python的时候一般会自动带上。

但是——国内用户直接用官方源,下载速度会慢到怀疑人生。所以装完Python后的第一件事,我建议顺手把pip源换成国内镜像:

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

之后装任何第三方库,速度都会快很多。这个操作等同于把“下载菜谱的仓库”从国外换到了国内,不影响任何功能。全世界的Python库都在里面,只是下载地址变了。

3. 编辑器/IDE别纠结:我推荐的组合是这样

我见过太多学习路线图,一上来就让你装VSCode、配插件、配虚拟环境、配调试器,然后配了一下午,报了一堆错,连第一行代码都没写。你要想清楚:第一周你的任务只有一个——把基础语法练熟。工具够简单就行,后面写复杂项目再升级。

3.1 第一阶段:一个能写字的编辑器就够了

真的,我见过高中学弟用Windows自带的“记事本”学完Python基础,一样学得好好的。你用任何纯文本编辑器写.py文件,然后在命令行里用python 文件.py运行,效果是一样的。编辑器只是提供了一个写字的界面,它不会改变Python本身的任何规则。

所以第一阶段,你只需要装一个称手的文本编辑器。Windows上用Notepad++或者VS Code都行,Mac上用VS Code或者Sublime Text都可以,关键是能打开.py文件、能正常打字保存即可。这个阶段别折腾任何东西。

3.2 VS Code配置Python:最小可用即可

当你要正式写代码了,我推荐VS Code。它是免费开源编辑器里的王者,跨平台,插件生态好。配置Python环境很简单,三步:

第一步,去code.visualstudio.com下载安装VS Code。

第二步,打开VS Code,在扩展市场里搜索“Python”,安装Microsoft官方出的那个Python扩展(认准发布者是Microsoft)。

第三步,Ctrl+Shift+P打开命令面板,输入Python: Select Interpreter,选择你刚才安装的Python解释器路径。如果你用的VS Code是中文界面,命令也对应是中文的。选择完毕后,VS Code就能弹出语法提示、运行按钮了。

然后你打开一个.py文件,右上角会出现一个三角形运行按钮,点它就能直接运行当前文件。核心配置就这么多,完事。

我见过不少人在VS Code里搞了一堆插件:代码格式化、代码检查、远程开发、容器开发……没那个必要。以后再装,现在装多了只会让你分心。

3.3 PyCharm适合什么样的人

PyCharm是JetBrains公司出品的专业Python IDE,功能非常强大,适合写中大型项目。但它的问题也很明显:重、慢、首次配置比VS Code更繁琐。对零基础学习者来说,第一周就用PyCharm,光是新建项目、配置解释器、设置虚拟环境这一套流程,就足够让你怀疑人生了。

我的结论:如果你是跟着一门课程或教材学习,老师明确用PyCharm演示,那就跟着用PyCharm的社区版(Community Edition,免费),版本选新的。否则一律推荐VS Code。把一个工具用熟练,比同时折腾两个工具强得多。

3.4 运行第一句代码(Hello World的完整链路)

弄明白工具之后,跑一个最经典的程序:

print("Hello, World!")

怎么做?新建一个文本文件,命名为hello.py,把这段话敲进去,保存。然后在命令行里:

python hello.py

屏幕上弹出Hello, World!的那一刻,你就算真正跨进了编程的门。这个仪式感很重要,不是玄学,是给你一个正反馈:我的环境没问题,我的代码能执行,后面越学越有信心。

4. 写第一个程序前,必须弄明白的核心概念

我知道你很着急想写代码,但有些基础概念如果第一遍没搞明白,后面返工的成本会大得多。这节讲的不是枯燥的语法背诵,而是几个你反复会用到、又特别容易懵的基石。

4.1 变量:就是给数据起一个名字

变量这个概念,听起来很抽象,其实特别简单:你用=号把一个值赋给一个名字,之后使用这个名字就相当于使用那个值。

name = "张三" age = 18 price = 3.99

name、age、price就是变量,它们分别记住了字符串、整数、浮点数。以后你在程序里写name,Python就知道你说的是"张三"。

为什么需要变量?因为程序里很多数据不是你提前写死的,而是程序跑起来后从外部读进来的。比如一个计算器程序,用户输入两个数,你得先把这两个数存在变量里,之后才能做加法。你可以把变量理解成一个贴了标签的盒子,标签就是变量名,盒子里装的是数据。

我之前看很多小白写代码,喜欢给变量命名为a、b、c,这样写起来倒是快,但过两天回来看自己写的代码,完全不知道每个变量是干什么用的。经验之谈:变量名要能“自解释”,比如user_name、total_price,读起来就知道它的用途。这是编程习惯,比很多技巧都重要。

4.2 类型与类型转换:别让“数字”和“字符”打架

Python里每个值都有一个类型,最常见的三种:

  • 整数int:比如3、-5、100。
  • 浮点数float:比如3.14、0.5,就是带小数点的数。
  • 字符串str:用引号包裹的一段文本,比如"你好"、'hello'。

这里有个特别容易踩的坑:3和"3"在Python眼里完全是两个东西。一个是数字,能用来做加减乘除;一个是字符串,只是一个文本符号,没法直接参与数学运算。

我给你看一个经典报错:

age = input("请输入你的年龄:") next_year_age = age + 1 print("明年你", next_year_age, "岁")

这段代码会报错,因为input()返回的一定是字符串,age是"18"而不是18,字符串和整数相加,Python不允许。

正确的写法是类型转换:

age = input("请输入你的年龄:") age = int(age) # 把字符串转成整数 next_year_age = age + 1

int()函数可以把字符串转成整数,str()函数可以把数字转成字符串,float()可以转成浮点数。这是三个你从第一天就会频繁用到的基本函数。

很多人不理解“为什么字符串和数字不能相加”,因为现实里“3个苹果”和“3个苹果”能加,“3个苹果”和“三个苹果”你想怎么加?类型不一致,操作就没意义。Python用报错来告诉你,逻辑上不通。

4.3 注释:最好的注释是让人看懂,其次是让Python忽略

Python里用#号表示注释。#后面的内容,Python在执行时会直接忽略。它是写给人看的,不是给机器看的。

# 这是注释 print("Hello") # 这里也是注释

新手常有一个误区:觉得注释是多余的,只要代码能跑就行。但等你写了一个几百行的脚本,过一周再看,你会发现如果不写注释,你自己都看不懂自己当时在想什么。我给学生的建议是:在写每一段有业务逻辑的代码前,先用一句中文注释写明你想做什么,然后再写代码。这不仅是写给别人看,更是帮你自己理清思路。

如果你用中文输入法,还有一个反复有人踩的小坑:在代码里打了中文的全角引号(“ ”)而不是英文半角引号("),结果Python报语法错误。别怀疑,这个报错我自己也碰过,看到SyntaxError: invalid character '“'就要立刻反应过来,引号输入法用错中英文了。

4.4 input()和print():程序和人说话的方式

print()是输出,把程序里的内容显示到屏幕上;input()是输入,程序停下来等用户从键盘输入内容,把用户输入的内容当成字符串返回。

name = input("请输入你的名字:") print("你好,", name)

print()可以一次打印多个内容,用逗号分隔,输出时它们之间会有空格。如果你不想有空格,可以把分隔符改掉:

print("你好,", name, sep="")

我在这里给新手一个忠告:学input()和print()的时候,一定要亲手实际操作几遍,而不只是看教程。亲手试一遍,你才能体会“程序停下来等输入”是种什么感觉,也才能理解为什么input()返回的一定是字符串。这个手感没有替代品。

4.5 缩进:Python的灵魂藏在代码开头

Python有一个和C、Java都不一样的地方:它用缩进来表示代码块的层级。别的语言用花括号{}来分块,Python用行首的空格或Tab。

if age >= 18: print("你已成年") print("可以考驾照了") print("这句话不受if控制")

第2、3行前面有4个空格,表示它们属于if条件成立的代码块;第4行没有缩进,表示它跟if无关,无论什么情况都会执行。

缩进不对,Python直接报IndentationError。这个报错对新手极其不友好,因为看起来一模一样的两行代码,一个多个空格,一个少个空格,结果一个能跑一个不能跑。我在练习环境里见过无数人问:为什么我一模一样的代码就是报unexpected indent?

答案往往就是:某一行前面多了或少了空格。我自己的习惯是统一用4个空格做缩进,绝不混用Tab和空格。现在大部分编辑器都会自动把Tab转成4个空格,但你还是要注意——混用Tab和空格是Python新手最隐蔽的报错来源。

4.6 基础语法工具箱:你不需要背,但要有印象

学习的第一阶段,铺垫几个高频关键字,不是让你背,而是让你之后看到不慌:

  • if/elif/else:条件判断,让程序根据不同情况走不同分支。
  • for/while:循环,让代码重复执行。
  • def:定义一个函数,把一段可复用的逻辑封装起来。
  • import:引入一个模块,借用别人写好的功能库。

这些概念在后续第2篇、第3篇里面我会专门讲细。现在你只需要知道它们的存在。

5. 从“能跑起来”到“不出错”:新手高频报错逐个拆

学了语法、能写程序之后,接踵而来的就是报错。报错不是洪水猛兽,它其实是Python在告诉你“你这段代码哪里没想清楚”。我整理了新手最常见的几类报错,提前给你打个预防针。

5.1 常见报错清单和它们的真实含义

报错真实含义最常见场景
SyntaxError语法错误,代码不符合格式少了冒号、括号没配对、中英文标点混用
IndentationError缩进错误某行该缩进没缩进,或者不该缩进多缩进
NameError: name 'x' is not defined变量x没定义变量名拼写错误,或者忘了赋值就直接使用
TypeError类型错误,数据类型不匹配字符串和数字相加、函数传参类型不对
ModuleNotFoundError模块没有找到忘用pip安装对应的库
FileNotFoundError文件没找到程序里写的文件路径不对

看报错有个技巧:先看最后一行,再看往上数的前几行。最后一行是结论,上面的代码片段是线索。很多新手一看到红字就慌,直接把整个报错截图丢给搜索引擎,但其实从最后一行就能看出问题。

5.2 遇到报错该怎么查:别死磕,也别乱搜

新手遇到报错,最常见的两种极端:一种是自己死磕一小时,一种是把报错整段复制到搜索引擎乱搜。这两种效率都很低。

正确姿势:把报错信息里的最后一行的错误类型和它指向的具体行号提取出来,再加上自己的代码摘要,去搜索。比如NameError: name 'x' is not defined,你不用连代码一起搜,直接搜这个错误类型,基本都能找到答案。

还有一个很实用的检查顺序:代码执行前先自查长这样三件事——1)是不是少了结尾冒号;2)是不是用了中英文标点混合;3)是不是变量名拼写不一致。这三件事能解决新手80%的报错。

5.3 命令行和文件路径常识,越早懂越好

后期跑代码,你需要和命令行打交道,一定会碰到“文件路径”的问题。我在这里先提一个重要概念:当前工作目录。你在命令行里执行python hello.py时,Python默认会在你目前所处的目录下找hello.py。如果你不在hello.py所在的目录,就会得到FileNotFoundError。

新手经常因为这个懵:明明双击文件能打开,在命令行里却说找不到。因为命令行的工作目录和你主观上以为的路径不一致。应对办法有两个:

  1. 用cd命令切换到代码所在目录(Windows用cd /d E:\project这种写法,Mac/Linux用cd ~/project);
  2. 在代码里写绝对路径,或者用os.chdir()切换工作目录。

这个话题后面讲到文件操作时会再展开,现在你心里有个印象就好。

5.4 英文报错别怕:把错误消息当成Python在跟你说话

最后想分享一个心态。很多新手一看到英文报错就头皮发麻,觉得是自己英语不好导致学不会编程。其实,编程跑不通的根源,绝大多数不是英语水平,而是逻辑没理顺。报错信息里的单词也就那么几十个高频的:unexpected(意外的)、invalid(无效的)、expected(期望的)、cannot(不能)、undefined(未定义)。看几次就熟了。

而且Python的报错已经算是编程语言里最友好、最详细的了。它会告诉你具体哪一行出错、甚至用箭头指出来问题在哪。你把报错当成Python在说人话,慢慢就习惯了。

6. 学完这一篇,接下来怎么走

Python学习的路径是递进的,第一篇我们解决的是“环境 + 最基本的运行机制 + 几个核心概念”。你学完这一篇,应该能够做到:独立安装Python、用VS Code编辑并运行一个.py文件、理解变量类型和输入输出的基本用法。这些是最底层的骨架,后面所有内容都建立在这之上。

接下来的一条清晰路线:

  • 第二篇:条件判断、循环、列表和字典,这时候你就有了“表达逻辑”的能力。
  • 第三篇:函数和模块,开始把大问题拆成小函数。
  • 第四篇:文件读写和异常处理,程序开始变得实用,比如批量处理文本、生成报告。
  • 第五篇:第三方库入门,用requests爬网页、用pandas处理表格、用matplotlib画图。热搜词里那些“python画图横坐标太密集”“层次聚类python”背后依赖的恰恰是这些基础能力。
  • 再往后才是爬虫、数据分析、Web开发、AI这些具体方向。

关于学习资源,我想多说几句。网上的免费教程非常多,比如各类Python入门视频、教程网站、官方文档。但资源多不等于你能学好,关键是少而精地学、多做练习。我建议你跟住一条主线教材或一套视频,尽量学完,不要今天看A老师的、明天看B老师的,学的全是开头三章。

练习也很重要。每学完一个知识点,立刻找个场景用上。比如今天学了变量和输入输出,你就写一个“BMI计算器”,让用户输入身高、体重,程序算出BMI并输出结果。别嫌简单,这个小小的程序能一次练到输入、类型转换、输出、变量名命名。等你能熟练完成它,再进入下一章,底子绝对比那些狂刷视频的人扎实得多。

还有一点:遇到报错、遇到卡住,别第一反应就放弃。先自己看报错提示,搜索一下,实在不行就休息几分钟再回来看。编程里有一个“卡住-突破”的正常节奏,每个人都会经历,区别只是有人习惯了这种节奏,有人被它吓退了。

最后给你一个小提醒:这篇我讲的很多坑,都是我当年一条一条踩过来的。比如全角引号、忘勾PATH、缩进混用Tab和空格,每一个都让当时的我抓狂。但回头看,这些恰是每个自学Python的人都要过的坎。你在第一次碰到的时候,记得“原来不只我这样”,然后再耐心把它解决了,你就真正前进了一步。

下一篇文章,我们开始正式进入Python的语法世界:变量、类型、条件判断、循环。等我把这套地基打完,你会发现后面学什么都快。到时候咱们再接着往下走。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询