零基础学Python第一步:Windows/Mac环境搭建与Hello World

顾星河
顾星河
发布时间:2026-11-01| 9人浏览过
原创

面向零基础学习者的Python环境搭建指南,详细介绍Windows与macOS双平台的安装配置、PATH环境变量检查、终端验证命令、常见报错排查,以及第一个Hello World程序的编写与运行。

搭建Python开发环境的核心在于让操作系统能够定位并调用Python解释器程序。无论使用Windows还是macOS,完整流程均包含三个明确节点:获取并安装官方Python解释器、在命令行中验证安装与环境变量状态、编写纯文本脚本并由解释器执行输出。本文提供Windows与macOS双平台的逐项配置操作,并运行第一个“Hello World”程序。

一、Windows平台下的Python安装与环境配置

Windows系统默认没有预装标准Python运行环境。安装时最核心的步骤是将Python的可执行文件路径注册到操作系统的环境变量(PATH)中,否则终端将无法直接识别命令。

1. 下载官方安装包

访问Python官方网站下载页面(python.org/downloads),网站会自动识别Windows系统并推荐最新的稳定版(如Python 3.12.x或3.11.x)。点击下载对应系统的64位安装包(Windows installer 64-bit),文件扩展名为 .exe。

2. 关键安装步骤:勾选 PATH 环境变量

双击运行下载好的安装包,在弹出的初始安装界面中,必须注意底部的选择框:

  • 勾选底部的 "Add python.exe to PATH"(部分旧版本为 "Add Python 3.x to PATH")。此步骤决定了能否在命令行窗口直接键入 python 命令。
  • 点击 "Install Now"(默认安装)即可开始自动安装;若需更改安装磁盘目录,可点击 "Customize installation" 自定义路径,但请确保安装路径中不含中文字符或特殊符号。
  • 安装结束界面若出现 "Disable path length limit"(解除系统路径260字符长度限制),建议点击确认,以避免后续安装复杂依赖库时出现路径过长错误。
零基础学Python第一步:Windows/Mac环境搭建与Hello World
图 1:Windows 环境安装步骤与 PATH 环境变量决策流

二、macOS平台下的Python安装与环境配置

macOS早前版本自带过时的Python 2.7,而较新的系统版本已不再内置标准Python运行时,仅在开发者命令行工具中提供受限的执行脚本。零基础学习切勿依赖或篡改系统自带组件,应独立安装最新的Python 3.x发行版。

1. 官方安装包安装(推荐初学者)

访问官方下载页面,下载适用于macOS的安装包(如 macOS 64-bit universal2 installer,文件扩展名为 .pkg)。双击打开后依照向导一路点击“继续”完成安装。

重要细节:运行 SSL 证书安装脚本
官方包安装完成后,会自动在“应用程序”中打开 Python 文件夹。该文件夹内包含名为 Install Certificates.command 的脚本文件,必须双击运行它。该脚本会自动为 Python 写入根证书集合,若忽略此步骤,后续使用网络请求或下载第三方库时会抛出 SSL 证书校验失败错误。

2. 命令行工具 Homebrew 安装(可选开发者途径)

如果电脑中已配置了 macOS 包管理工具 Homebrew,可直接打开“终端”(Terminal)输入以下命令:

输入命令(Terminal)
brew install python

Homebrew 会自动拉取最新的 Python 3 解释器及其核心依赖,并将其软链接至系统路径 /opt/homebrew/bin/python3(Apple Silicon芯片)或 /usr/local/bin/python3(Intel芯片)。

零基础学Python第一步:Windows/Mac环境搭建与Hello World
图 2:macOS 系统环境与 Python3 解释器寻址关系

三、命令行环境验证与常见错误排查

完成安装后,需要开启全新的终端窗口(Windows下为命令提示符CMD或PowerShell;Mac下为终端Terminal)进行验证。不要在安装前已经打开的窗口中直接测试,因为旧窗口未加载最新的系统环境变量。

1. 验证命令与标准输出

在终端中输入以下指令查询Python版本:

Windows 验证命令
python --version
macOS 验证命令
python3 --version
正常输出示例(标明已就绪)
Python 3.12.2

继续验证包管理工具 pip 是否就绪:

验证 pip(Windows / macOS)
pip --version # 或在 macOS 下: pip3 --version
正常输出示例
pip 24.0 from /usr/local/lib/python3.12/site-packages/pip (python 3.12)

2. 常见报错表现与针对性修复

现象 / 报错信息 产生原因 具体解决方法
'python' 不是内部或外部命令 Windows安装时未勾选 "Add to PATH" 重新双击安装包,选择 "Modify",补勾 "Add Python to environment variables";或手动在“系统属性-环境变量”中添加Python安装路径。
输入 python 自动弹出 Windows 应用商店 系统自带的应用执行别名占用了 python 名称 打开系统“设置” → 搜索“管理应用执行别名” → 将“应用安装程序 (python.exe)”的开关关闭。
zsh: command not found: python macOS未配置 python 默认别名 输入 python3 代替,或在 ~/.zshrc 中加入 alias python="python3" 并执行 source ~/.zshrc。
零基础学Python第一步:Windows/Mac环境搭建与Hello World
图 3:终端环境验证与常见异常排查分支

四、编写与运行第一个程序:Hello World

Python代码可以通过两种方式执行:终端交互式命令行(REPL)与保存为脚本文件执行。学习编程应当主要以“编写脚本文件”为主,便于保存、重构与执行完整逻辑。

1. 方式一:交互式命令行试运行

在终端中直接键入 python(或Mac下的 python3)并回车,终端提示符会变为 >>>,这代表已进入Python交互式解释器环境:

交互式指令
>>> print("Hello, World!")
终端即时输出
Hello, World!

输入 exit() 并回车,即可安全退出交互模式,返回操作系统的常规命令行。

2. 方式二:标准脚本文件编写与运行(核心方式)

交互式环境关闭后代码不保存,因此必须创建独立的源代码文件:

  1. 新建代码目录与文件:在电脑中新建一个学习文件夹(例如桌面上的 py_demo)。使用专业代码编辑器(如 VS Code、Sublime Text)或系统自带的纯文本记事本,新建文件并命名为 hello.py。特别注意:文件扩展名必须是 .py,而不是 .txt 或 .docx。
  2. 输入代码内容:在文件内写入一行标准代码:
代码内容(hello.py)
print("Hello, World!")
  1. 保存并切换工作路径:保存该文件。打开终端,使用 cd 命令切换到该文件所在的目录:
路径切换命令(示例)
cd Desktop/py_demo
  1. 调用解释器执行脚本:输入执行命令:
执行脚本命令
# Windows: python hello.py # macOS: python3 hello.py
运行结果
Hello, World!

3. 代码要素解析

print() 是Python内置的输出函数,用于将括号内的内容打印在终端上;英文双引号 "Hello, World!" 表示这是一个“字符串”(即文本数据)。初学者容易犯的语法错误是将英文标点误输入为中文全角标点,例如写成中文括号 () 或中文双引号 “”,这会导致解释器报告 SyntaxError: invalid character 语法错误。

零基础学Python第一步:Windows/Mac环境搭建与Hello World
图 4:Python 代码从编写到终端输出的执行全生命周期

五、新手注意事项与良好操作习惯

完成环境搭建和首个程序运行后,建议在后续开发中建立以下操作习惯,以规避绝大多数初学者经常遇到的卡顿问题:

  • 使用纯文本与专业代码编辑器:绝不要使用 Windows 记事本的“自动换行”或 Word 等富文本编辑器编写代码,此类软件会引入隐藏的 BOM 字符或将标点自动转换为中文全角,导致代码无法解析。推荐安装轻量且通用的 Visual Studio Code,并安装官方 Python 扩展。
  • 文件命名规范:脚本文件名请一律使用小写英文字母、数字和下划线,例如 lesson_01.py。不要在文件名中使用中文、空格或连字符,严禁将脚本命名为 python.py、test.py 或与标准库同名的文件名(如 math.py、random.py),否则会导致模块导入冲突。
  • 明确当前工作目录:在命令行运行脚本时,确保终端提示符所在路径与脚本文件所在目录一致;若不在同一目录,必须使用 cd 切换到目标路径,或在命令行中指定完整的文件相对/绝对路径。

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。