Python脚本编写入门：怎么创建并运行第一个.py文件

一、准备工作：确认系统已安装 Python 解释器

在创建脚本之前，必须首先确保操作系统中能够找到 Python 解释程序。与可以直接被 CPU 执行的机器码（如 Windows 下的 .exe 程序）不同，以 .py 结尾的 Python 脚本是人类可读的纯文本指令。计算机并不能直接看懂这些文本，必须借助名为“Python 解释器”的底层引擎，将其逐步翻译为字节码并交给虚拟机求值。

读者可以通过系统自带的命令行终端快速验证当前电脑是否已经具备 Python 环境：

• Windows 系统：按下键盘快捷键 Win + R，在弹出的“运行”窗口中输入 cmd 或 powershell 并回车打开控制台。
• macOS 系统：按下 Cmd + 空格键 打开聚焦搜索（Spotlight），输入 Terminal 或“终端”并回车。
• Linux 系统：使用系统快捷键 Ctrl + Alt + T 打开默认终端。

python --version

如果终端提示“不是内部或外部命令”或“command not found”，说明当前计算机尚未安装 Python，或者在安装时未勾选“Add python.exe to PATH”（将 Python 路径添加至环境变量）。此时需前往 Python 官方网站（python.org）下载对应系统的安装包完成安装，并在安装引导首页务必勾选添加环境变量复选框。

二、创建脚本文件：规避格式陷阱与命名规则

确立好解释器环境后，第二步是建立承载代码的文件。Python 代码文件在本质上就是纯文本文件，只是其后缀名被约定为 .py。

为了让代码管理更加规范，不建议将脚本散落存放在桌面上。建议在硬盘中专门新建一个用于练习代码的专属文件夹，例如在 Windows 的 D 盘根目录或用户目录下创建 python_learning，或者在 macOS 的用户家目录下创建 ~/python_learning。

1. 编辑工具的选择原则

新手最常犯的一个隐蔽错误是使用日常排版软件（如 Microsoft Word、WPS 文字、Windows 写字板或 macOS 默认富文本模式下的文本编辑）来写代码。这些富文本排版软件在保存时，会在文件头部和段落中嵌入大量不可见的字体样式、排版控制代码与 XML 标记。当 Python 解释器试图解析这些文件时，会因为遇到无法识别的非代码二进制字符而直接抛出语法错误（SyntaxError）。

因此，编写 Python 脚本必须始终使用纯文本编辑器。初学者可以选择以下工具之一：

• 轻量级纯文本记事本：Windows 自带的“记事本”（Notepad）或 macOS 系统自带的“文本编辑”（需在菜单栏偏好设置中切换为“纯文本模式”）。
• 专业代码编辑器（强烈推荐）：Visual Studio Code（VS Code）、Sublime Text 或 Notepad++。这些工具不仅能保证纯文本输出，还自带代码颜色高亮与行号辅助。

2. 防范 Windows 隐藏已知文件扩展名

在 Windows 默认设置下，系统会隐藏常见文件的后缀名。这会导致读者在桌面上新建一个名为 hello.py 的文本文档时，系统在后台悄悄为其追加了 .txt，最终生成的完整文件名实际上是 hello.py.txt。当你在终端输入 python hello.py 时，系统就会报找不到文件。

消除这一隐患的明确操作是：打开 Windows“此电脑”或任意文件夹窗口，在顶部功能区点击“查看”标签页，在显示选项中明确勾选“文件扩展名”。在显示真实扩展名后，新建文本文档并将其重命名为 hello.py，在系统弹出的“如果改变文件扩展名，可能会导致文件不可用”警告中点击“是”。

三、编写第一行代码：规范与语法解析

文件创建完毕后，使用刚才选定的文本编辑器或 VS Code 打开这个 hello.py 文件。在空白编辑区中输入以下标准测试代码：

print("Hello, Python!")

虽然这行代码只有短短二十几个字符，但它已经涵盖了 Python 核心的基础语法要素，理解它们有助于避免后续的大多数语法报错：

1. print 内置函数：这是 Python 语言内置的输出机制。它的作用是将括号内部的数据转换成可见字符，并输出到系统标准输出流（stdout）中。
2. 半角英文括号 ()：在 Python 中，函数调用必须通过成对的小括号传递参数。注意这里的括号必须是在英文半角输入法状态下输入的符号。
3. 成对英文双引号 "..."：双引号包裹的内容在 Python 中被判定为“字符串字面量”（String Literal）。Python 支持英文双引号 "" 或英文单引号 ''，但两端必须类型一致，且同样不能使用中文全角引号（如 “”）。

输入完成后，按下快捷键 Ctrl + S（macOS 为 Cmd + S）保存文件。此时，本地磁盘上已经存在了一个结构合法、内容合规的完整 Python 源码文件。

四、在终端中定位并运行 .py 脚本

有了源码文件之后，最重要的环节是让 Python 解释器去执行它。很多初学者习惯性地双击 hello.py 文件图标，往往会发现一个黑色窗口一闪而过，然后什么都没留下。这是因为 Windows 确实启动了解释器去执行该脚本，但由于代码只有一行 print，执行只需几毫秒，输出完毕后进程立刻终止，承载控制台的黑窗口便随之自动销毁。

正确的做法是预先打开终端窗口，使用命令行主动调用解释器。这样执行完成后终端窗口依然保持开启，所有的输出结果与潜在报错日志都会清晰保留在屏幕上。

步骤 1：打开终端并切换到脚本所在目录

运行脚本的前提是让命令行终端的“当前工作目录”指向你的代码所在的文件夹。这里需要使用通用的目录切换命令 cd（Change Directory）。

例如，若你的 hello.py 保存在 D:\python_learning 文件夹中，在 Windows 终端中操作如下：

# 若跨盘符，先切换到对应盘符（输入 d: 回车）
d:
cd D:\python_learning

若在 macOS 或 Linux 系统中，假设保存在家目录的 python_learning 文件夹下：

cd ~/python_learning

步骤 2：验证当前目录存在目标文件

在键入运行命令前，可以快速查看当前目录下是否有刚刚创建的脚本：

• Windows 系统输入命令：dir 并回车
• macOS / Linux 系统输入命令：ls 并回车

检查打印出的文件清单中是否存在 hello.py。如果能看到这个文件名，说明当前路径完全正确。

步骤 3：发起命令调用解释器

在终端光标后输入启动命令并按下回车：

python hello.py

（注：macOS 或 Linux 用户如果前面测试时使用的是 python3，请相应输入 python3 hello.py）

此时，终端会准确打印出 Hello, Python!，并在下一行重新显示命令提示符（等待接收下一条指令）。这标志着第一个 Python 脚本已经顺利执行完成。

五、新手初次运行常见报错与排查指南

初次编写和运行脚本时，即使漏掉一个空格或标点符号也会触发异常。遇到报错不必慌张，Python 终端打印的错误信息非常清晰，通常已经直接指出了问题原因所在。下表归纳了入门阶段最高频出现的三种错误表现及对应解决办法：

六、全流程总结与学习路径

回顾整个操作过程，编写并运行一个基础 Python 脚本的核心闭环由四个要素构成：准备解释环境、纯文本编写、终端路径导航、调用命令执行。这一套“代码文件 + 终端命令”的运行模式是现代软件开发的基础通用范式，后续无论编写数百行的爬虫、数据分析脚本还是后端服务，其本质都延续这一流程。

在成功运行了输出静态文字的 hello.py 之后，读者便迈过了最容易被环境和命令劝退的初学门槛。接下来可以沿着以下三个层次循序渐进地扩展脚本功能：

• 加入人机交互：尝试学习内置函数 input("请输入您的名字：")，将控制台输入的文本赋值给变量并组合打印，让脚本具备动态响应能力。
• 引入条件与循环：使用 if ... else 分支结构与 for 循环，使脚本能够根据条件自动做出判断、重复批量处理文本行或计算数据。
• 调用系统标准库：通过 import os 或 import sys，编写可以自动读取本地文件、批量重命名文件夹内容的实用自动化小工具。

只要牢记在纯文本环境中书写合法英文半角字符，并在对应目录的终端中调起 Python 解释器，任何复杂的程序都可以从这一个小小的 .py 文件开始生根发芽。