零基础编程教程：从安装工具到写出第一个程序

第一次写程序，不需要先学完一整套理论，也不用急着安装很多开发工具。本文用 Python 带你走完一个完整的小流程：安装运行环境、创建代码文件、执行程序、读懂报错，再动手做一个可以保存数据的小工具。

Python 适合初学者，是因为语法相对简洁，也广泛用于自动化、数据处理、网站后端和人工智能相关开发。不过，“容易上手”不等于写出程序就能解决所有问题。程序只能按明确的规则工作，操作文件或连接网络时也需要考虑权限、隐私和安全。理解这些边界和写出代码同样重要。

一、先判断 Python 是否适合你的任务

Python 常见的适用场景包括：

• 自动化重复操作：例如整理文件名、处理文本、批量统计表格数据。自动化前要确认操作范围，避免误删或覆盖文件。
• 数据处理：读取文本、CSV 等数据并进行计算。更复杂的 Excel、图像或科学计算任务通常需要另装第三方库。
• 学习编程基础：通过变量、条件、循环、函数等概念，练习把需求拆成步骤。
• 服务端开发和脚本工具：可以用 Python 构建，但正式部署还涉及测试、依赖管理、权限、日志和维护。

Python 并非任何任务的最佳选择。对实时性要求很高、需要直接操作某些硬件，或必须在浏览器中运行的程序，可能需要其他语言或平台。手机应用也不能仅靠一段普通 Python 脚本就自动变成完整 App。本文的目标是学会编写和运行本地命令行程序，不涉及网页部署或移动应用打包。

二、安装 Python 和编辑器

1. 安装 Python

请从 Python 官方网站的下载页面获取安装程序，网址是 https://www.python.org/downloads/。不同操作系统的安装界面和版本会变化，按照官网当前提供的稳定版本安装即可。本文示例只使用 Python 标准库，不依赖某个特定的小版本；建议选择仍受支持的 Python 3 版本。

• Windows：运行官方安装程序。若安装界面提供“Add python.exe to PATH”选项，初学者可以勾选，这通常能让终端识别 python 命令。若之后仍无法识别，可使用 Windows 的 Python 启动器 py。
• macOS：可以安装官方提供的 macOS 安装包。不要为了运行示例而随意删除或替换系统组件；示例只需要一个可用的 Python 3。
• Linux：可先检查发行版是否已有 Python 3。若需要安装，优先使用该发行版的软件包管理器或 Python 官方建议的方法。不同发行版的包管理命令不同，不建议照抄其他系统的安装命令。

安装后打开终端，验证版本。Windows 可以试试 py --version 或 python --version；macOS 和 Linux 通常使用 python3 --version。如果命令能打印类似 Python 3.x.x 的版本号，说明终端找到了 Python。这里的 x 代表具体版本数字，不是需要原样输入的字符。

python3 --version

如果这条命令在 Windows 上无效，不代表 Python 一定没装好，可改试：

py --version

不要同时随意安装多个来源不明的 Python 发行版。电脑上存在多个 Python 版本并不罕见，但刚入门时应先弄清楚自己实际运行的是哪一个。

2. 安装代码编辑器

代码可以写在纯文本编辑器里。为了获得语法高亮、缩进提示和错误定位，初学者可以安装 Visual Studio Code（VS Code）或其他可信的代码编辑器。编辑器只是帮助你编写文件的工具，不是 Python 本身；装了编辑器但没装 Python，仍然无法运行本地 Python 程序。

安装后可以先不加装插件。若要安装 Python 扩展，请从编辑器的官方扩展市场确认发布者和名称。插件能提供辅助，但不会自动保证程序正确或安全。

三、认识终端、文件和运行方式

终端是输入命令的文本界面。命令提示符、PowerShell、macOS 的“终端”和 Linux 的终端都是常见形式。我们会用终端切换目录并运行程序。需要区分两种输入：

• 终端命令输入在终端里，例如 python3 hello.py。
• Python 代码写进以 .py 结尾的文件中，例如 hello.py。

不要把终端命令粘进 Python 文件，也不要把 Python 语句当作系统命令执行。初学者常见的困惑，往往来自没有区分这两种环境。

四、写出第一个程序

先在容易找到的位置新建一个文件夹，例如 python-start。打开编辑器，将这个文件夹作为工作目录，再新建文件 hello.py。输入以下代码：

print("你好，Python！")
print("这是我的第一个程序。")

保存文件。然后在终端进入这个文件夹，并执行程序。具体切换目录的命令取决于文件夹所在位置；也可以使用编辑器提供的“在集成终端中打开”功能。

python3 hello.py

如果使用 Windows 的 Python 启动器，命令可以是：

py hello.py

你应该看到两行文字输出。这里的 print() 是 Python 提供的函数，用来把内容显示到终端。括号中的文字放在引号里，表示字符串，也就是一段文本。

运行成功后，记住这个基本流程：编辑代码—保存文件—在终端运行—查看输出。改了文件却忘记保存，运行的仍可能是旧版本；运行命令中的文件名或目录不对，也会导致找不到文件。

五、做一个可以交互的小程序

接下来让程序向用户询问姓名，并给出问候。把 hello.py 的内容替换为：

name = input("请输入你的名字：")
print("你好，" + name + "！")

运行后，程序会停下来等待输入。键入内容并按回车，它再继续执行。input() 会返回用户输入的文本；变量 name 用来保存这段文本，之后可以通过变量名重复使用它。

如果输入内容是数字，input() 返回的依然是文本。例如输入 18，得到的是字符串 "18"，不是整数 18。需要做算术计算时，要明确转换类型：

age_text = input("请输入年龄：")
age = int(age_text)
print("明年你将满", age + 1, "岁。")

输入 18 时，程序可以输出 19。但若输入“十八”或留空，int() 无法把它转换为整数，程序会报 ValueError。这不是 Python 随机出错，而是输入不符合转换要求。

六、加入判断和循环：制作一个简单计算器

下面的程序读取两个数字和一个运算符，完成加、减、乘、除。把代码保存为 calculator.py：

first_text = input("请输入第一个数字：")
operator = input("请输入运算符（+、-、*、/）：")
second_text = input("请输入第二个数字：")

try:
    first = float(first_text)
    second = float(second_text)
except ValueError:
    print("输入无效：两个操作数都必须是数字。")
else:
    if operator == "+":
        result = first + second
        print("结果：", result)
    elif operator == "-":
        result = first - second
        print("结果：", result)
    elif operator == "*":
        result = first * second
        print("结果：", result)
    elif operator == "/":
        if second == 0:
            print("不能除以 0。")
        else:
            result = first / second
            print("结果：", result)
    else:
        print("不支持这个运算符。")

这里出现了几种重要结构：

• float() 把可表示为数字的文本转换成浮点数，可以处理如 3.5 这样的输入。
• if、elif 和 else 用来根据条件选择分支。Python 用缩进标记代码块，缩进不一致可能引发错误或改变程序结构。
• try 和 except 用来处理特定异常。这里捕获的是数字转换失败时的 ValueError。
• 除法前检查除数是否为零。浮点数计算结果可能有精度误差，因此该示例适合演示基本运算，不适用于要求严格精确的金融计算。

这个计算器只接受四种运算符，不支持括号、复杂表达式、单位换算或任意长度的数学公式。程序也没有限制用户输入的数值范围。真实业务需要按需求定义范围、精度和错误处理，不能因为示例能运行就认为它已经适合所有场景。

七、把程序拆成函数

功能越来越多时，可以用函数给一段操作起名字，减少重复代码。以下示例定义一个计算两数平均值的函数：

def average(first, second):
    return (first + second) / 2


value = average(8, 10)
print("平均值：", value)

def 用来定义函数，括号里的 first 和 second 是参数。调用 average(8, 10) 时，函数返回计算结果，再由变量 value 保存。函数参数的名称可以自行选择，但要让含义清楚。

函数能帮助组织代码，不会自动验证输入，也不会自动让代码更安全。若函数要处理用户输入、文件路径或网络内容，仍需检查这些数据是否符合预期。

八、完成一个小项目：保存待办事项

这个项目会让用户输入一条待办事项，并将其追加到当前工作目录里的 todo.txt 文件。它使用 Python 自带的 pathlib，无需安装额外软件包。新建文件 todo.py，写入：

from pathlib import Path

todo_file = Path("todo.txt")
task = input("请输入一条待办事项：").strip()

if not task:
    print("内容为空，没有保存。")
else:
    with todo_file.open("a", encoding="utf-8") as file:
        file.write(task + "\n")
    print("已保存到：", todo_file.resolve())

运行它：

python3 todo.py

Windows 上也可以按前面的方式使用 py todo.py。输入一条内容并按回车，程序会在当前工作目录创建或更新 todo.txt。再次运行时，新内容会添加到文件末尾，而不是替换旧内容。

这里的 "a" 表示追加写入。如果把它改成 "w"，打开文件时原有内容通常会被截断并重新写入，所以不能在不理解影响的情况下随意更换模式。encoding="utf-8" 指定文本编码，有助于跨平台保存中文。with 代码块结束时会关闭文件。

程序保存文件的位置取决于运行时的当前工作目录，不一定等于 todo.py 文件所在目录。todo_file.resolve() 用来显示解析后的路径，方便确认文件实际写到哪里。首次运行前，应检查终端所在目录，避免在不希望的位置创建文件。

这个待办工具只是本地文本记录，不包含加密、用户认证、云同步、备份或多人协作。请勿把密码、身份证号等敏感信息当作待办事项保存；普通文本文件可能被有权限访问该文件或设备的人读取。

九、读懂常见错误

刚开始编程时遇到错误非常正常。与其反复重写，不如从报错信息里找线索。

• SyntaxError：语法不符合 Python 规则。常见原因是漏掉引号、括号，或使用了不匹配的引号。检查报错行附近的代码，错误位置不一定恰好就是唯一原因。
• IndentationError：缩进不符合要求。条件分支、循环、函数等代码块需要一致的缩进。建议使用编辑器的缩进功能，不要在同一代码块里混用空格和制表符。
• NameError：使用了尚未定义的名称，或拼写与定义时不一致。Python 的大小写有区别，name 和 Name 是不同名称。
• ValueError：值的形式不符合操作要求，例如把“很多”传给 int()。应检查输入，并在需要时给出清晰提示。
• FileNotFoundError：程序寻找的文件不存在，或者当前工作目录不对。确认文件名、目录和运行位置。
• “找不到 python 命令”：终端未找到对应程序。确认安装是否成功，重新打开终端，再按系统尝试 python、python3 或 Windows 的 py。

排错时，可以依次检查：报错最后几行、文件是否保存、运行命令是否正确、文件名和路径是否一致、输入是否符合程序要求。一次只改一处并重新运行，比同时改动很多地方更容易找到原因。

十、安装第三方库时要注意什么

本文的例子都使用 Python 标准库，通常不需要额外安装包。以后遇到确实需要的第三方库，可以阅读项目文档，确认支持的 Python 版本和安装方式。不同项目可能有不同要求，不存在一个能解决所有依赖问题的安装命令。

第三方库通常通过 pip 安装。下面只是常见示例，具体是否适用应以该库的说明为准：

python -m pip install 包名

在部分系统中，需要把 python 换成 python3 或使用 Windows 的 py -m pip。为不同项目建立独立的虚拟环境，可以减少依赖相互影响；但初学者不必为了运行本文程序先配置复杂环境。

安装软件包意味着执行来自外部的代码。应确认项目来源、维护状况和安装目标，不要复制来历不明的安装命令。尤其要谨慎对待要求管理员权限、读取敏感文件或关闭安全防护的指令。

十一、参数限制和安全边界

本教程的程序面向单机练习，不是经过安全审计的产品。它们不具备登录权限控制、用户隔离、数据加密、可靠备份或高并发处理能力。若要用于团队或生产环境，需要根据实际威胁和业务要求补充设计、测试与审查。

运行他人提供的代码前，应先查看代码内容和来源。不要为了“让它跑起来”就以管理员身份执行不理解的程序，也不要把终端里具有删除、覆盖或修改系统设置能力的命令盲目粘贴运行。程序的操作能力取决于当前账户权限；普通脚本并不会因为是 Python 就自动安全或危险。

使用 input() 获得的内容应视为未经验证的输入。本文只把它用于简单文本或数字转换，没有展示数据库、网页模板或命令执行场景。若将用户输入拼进 SQL、HTML 或系统命令，可能引入注入等安全问题；应采用相应的安全接口和输入处理方式，而不是只靠删除几个特殊字符。

Python 的 eval() 可以把字符串当作 Python 表达式执行，不适合用来计算不可信用户输入。遇到需要解析用户提供的数学表达式等需求，应选用有明确安全边界的解析器，并仔细限制允许的语法；不要把不可信内容交给通用代码执行接口。

本教程未设置数值输入的业务上限。对来自外部的输入，实际程序通常还要考虑长度、范围、格式、文件大小和错误频率等限制。输入验证可以减少意外和部分滥用，但不能代替权限控制、访问控制和安全测试。

十二、下一步怎么练习

学会运行示例后，建议修改程序，而不是只复制粘贴：

• 给问候程序增加一个空名字检查。
• 为计算器增加取余运算，并处理除数为零的情况。
• 给待办工具增加“查看已有事项”的功能，先读取文件再逐行显示。
• 在每次运行前先做一份 todo.txt 副本，观察追加和覆盖模式的区别。

每增加一个功能，就想清楚程序接收什么输入、输出什么结果、遇到无效输入怎么办、会修改哪些文件。这样做能把“能运行”逐步提升为“行为可理解、结果可检查”。

从零开始学编程的关键，不是记住所有语法，而是反复练习拆解问题、编写小段代码、运行并根据反馈修正。先熟悉终端和文件，再逐步学习数据结构、模块、测试和依赖管理。保持每次改动足够小，并在执行文件操作前确认目标路径，你就已经具备了开始编写实用程序的基础。