如何自学编程：从选择语言到完成第一个项目

自学编程容易卡在两个地方：一开始不知道该学哪种语言，学了一些语法后又不知道怎样把知识变成程序。解决办法不是同时学很多语言，也不是等“学完”再动手，而是先确定想解决的问题，选一条足够用的技术路线，再通过一个小项目反复练习。

本文从场景选择、学习顺序和开发工具讲起，最后用 Python 写一个能够添加、查看和完成待办事项的命令行程序。示例可以在本地运行，也会说明它适合什么、不适合什么，以及如何避免入门阶段常见的错误。

一、先明确：你想用编程做什么

编程语言是表达计算过程的工具。没有适用于所有任务的“最佳语言”，更实用的问题是：你要开发什么、在哪个平台运行、是否需要和现有系统协作？先写下一两个具体目标，例如“整理一批文件名”“做一个个人网站”或“为工作表格自动生成汇总”。目标越具体，越容易选择工具和判断学习进度。

如果目标还不明确，但希望先练习通用编程概念，可以从 Python 或 JavaScript 开始。选定后先坚持一段时间，不要因为某个教程使用另一种语言就频繁换工具。变量、条件、循环、函数、数据结构、错误处理和拆分问题的能力可以迁移；不同语言的语法、运行方式和生态则需要分别熟悉。

二、准备好最小开发环境

以本文的 Python 示例为例，需要安装 Python 3，并在终端中确认运行环境。不同操作系统安装方式略有差异，优先使用 Python 官方发行版或操作系统可信的软件源。安装后运行：

python --version

部分系统使用以下命令：

python3 --version

确认能显示 Python 3 的版本号即可。若命令不存在，通常是尚未安装，或安装目录没有加入系统的命令搜索路径。不要通过随意下载来历不明的“优化版解释器”解决问题。

编辑器可以先用自己熟悉的一款。初学阶段不需要配置复杂插件；保存一个以 .py 结尾的文件，再用终端运行，比一次安装很多扩展更容易判断问题来自哪里。建议同时熟悉终端中的几个动作：进入目录、列出文件、运行程序。命令名称在 Windows、macOS 和 Linux 上可能不同，按自己的系统调整即可。

三、按什么顺序学习

1. 表达式与变量：理解数字、字符串、布尔值以及赋值。变量是程序中保存和传递数据的名称，不是固定类型的盒子。
2. 条件与循环：用 if 表达分支，用循环重复处理一组数据。练习边界情况，例如空列表和重复输入。
3. 容器：学习列表、字典和集合。选择结构时要问自己：数据是有顺序的一组值、键值映射，还是不重复的成员集合？
4. 函数：把一段有明确用途的逻辑封装起来，使用参数接收输入、用返回值交付结果。函数不只是为了缩短代码，也能帮助隔离和测试逻辑。
5. 文件与错误处理：练习读取和写入文本、JSON 等常见格式，理解文件不存在、数据格式错误和权限不足等失败情况。
6. 项目结构与外部依赖：知道如何组织多个文件、安装依赖、阅读文档，并区分标准库和第三方包。

不必等每个概念都“彻底掌握”才开始项目。可以采用“学一点、用一点”的循环：看一个概念的短例子，合上教程自己写一遍，再改动输入或规则观察结果。只复制粘贴运行一次，不足以证明理解；能预测程序在不同输入下的行为，才算开始掌握。

四、完成一个小项目：命令行待办清单

项目要做什么

程序支持三项操作：添加待办、查看待办、标记完成。数据保存在运行目录下的 todos.json 文件中，程序退出后仍可读取。这个项目覆盖参数解析、列表和字典、JSON 文件读写、输入检查以及异常处理，不需要安装第三方库。

它也有明确边界：这是供本地练习的命令行工具，不包含多用户、云端同步、加密、访问控制或并发写入保护。不要把它当作可靠的团队任务系统，也不要将敏感信息当作待办内容写入明文文件。

创建并运行

新建文件 todo.py，将下面代码完整保存进去。示例使用 Python 3.9 或更新版本；它只使用 Python 标准库。

import argparse
import json
from pathlib import Path

DATA_FILE = Path("todos.json")


def load_todos():
    if not DATA_FILE.exists():
        return []

    try:
        data = json.loads(DATA_FILE.read_text(encoding="utf-8"))
    except json.JSONDecodeError as exc:
        raise SystemExit(
            f"数据文件不是有效 JSON：{DATA_FILE}。"
            "请先备份并检查该文件。"
        ) from exc

    if not isinstance(data, list):
        raise SystemExit("数据文件格式错误：顶层内容应为列表。")

    for item in data:
        if (
            not isinstance(item, dict)
            or not isinstance(item.get("id"), int)
            or not isinstance(item.get("text"), str)
            or not isinstance(item.get("done"), bool)
        ):
            raise SystemExit("数据文件中存在格式不正确的待办记录。")

    return data


def save_todos(todos):
    DATA_FILE.write_text(
        json.dumps(todos, ensure_ascii=False, indent=2) + "\n",
        encoding="utf-8",
    )


def add_todo(text):
    text = text.strip()
    if not text:
        raise SystemExit("待办内容不能为空。")

    todos = load_todos()
    next_id = max((item["id"] for item in todos), default=0) + 1
    todos.append({"id": next_id, "text": text, "done": False})
    save_todos(todos)
    print(f"已添加 #{next_id}: {text}")


def list_todos():
    todos = load_todos()
    if not todos:
        print("还没有待办事项。")
        return

    for item in todos:
        mark = "已完成" if item["done"] else "未完成"
        print(f'#{item["id"]} [{mark}] {item["text"]}')


def complete_todo(todo_id):
    todos = load_todos()
    for item in todos:
        if item["id"] == todo_id:
            item["done"] = True
            save_todos(todos)
            print(f"已完成 #{todo_id}: {item['text']}")
            return

    raise SystemExit(f"找不到编号为 {todo_id} 的待办事项。")


def main():
    parser = argparse.ArgumentParser(
        description="保存到本地 JSON 文件的简单待办清单"
    )
    commands = parser.add_subparsers(dest="command", required=True)

    add_parser = commands.add_parser("add", help="添加一项待办")
    add_parser.add_argument("text", help="待办内容")

    commands.add_parser("list", help="列出所有待办")

    done_parser = commands.add_parser("done", help="标记待办为完成")
    done_parser.add_argument("id", type=int, help="待办编号")

    args = parser.parse_args()

    if args.command == "add":
        add_todo(args.text)
    elif args.command == "list":
        list_todos()
    elif args.command == "done":
        complete_todo(args.id)


if __name__ == "__main__":
    main()

在保存 todo.py 的目录中打开终端，依次运行以下命令：

python todo.py add "学习 Python 函数"
python todo.py list
python todo.py done 1
python todo.py list

如果系统用 python3 启动 Python，把命令中的 python 替换为 python3。第一次运行添加命令后，当前目录会出现 todos.json。如果先前已经创建过数据文件，编号未必是 1；先运行 list，再把实际编号传给 done。内容含空格时应加引号，具体引号规则会受所用终端影响。

读懂程序的几个关键部分

argparse 负责解析命令行参数。例如 add、list 和 done 是三个子命令；done 的编号通过 type=int 转换，无法转换的输入会由参数解析器报告错误。它减少了手工检查参数的工作，但不会替代所有业务规则检查。

load_todos 处理两种常见情况：文件不存在时返回空列表，JSON 语法错误时停止并提示检查文件。随后代码还检查记录的基本类型，避免程序把明显不符合预期的数据当成待办使用。这种检查不是完整的数据校验，也不能证明文件来自可信来源。

json.loads 和 json.dumps 用来把 JSON 文本转换成 Python 数据，以及把 Python 数据转换回 JSON 文本。JSON 只是数据格式；与用 pickle 加载不可信数据不同，解析 JSON 不会按格式描述执行 Python 对象构造代码。不过，任何输入都仍需考虑体积、内容和后续使用方式。这里的数据文件位于当前工作目录，因此从不同目录启动程序，读写的可能是不同的 todos.json。

save_todos 使用 UTF-8 编码，ensure_ascii=False 让中文在文件中保持可读。此示例直接覆盖目标文件：它不提供事务、并发控制或崩溃后恢复保证。若程序在写入中断、磁盘空间不足，文件可能未按预期保存；需要更高可靠性时，应设计备份或原子写入流程，并进行相应测试。

五、怎么调试：把“不能运行”拆成具体问题

第一次运行出错很正常。不要立刻重写整份代码，可以按下面顺序检查：

1. 确认运行位置：终端所在目录里是否有 todo.py？保存文件时有没有误存成 todo.py.txt？
2. 看完整错误信息：Python 通常会给出异常类型和文件行号。先定位最后几行，再回到对应代码核对变量名、括号和缩进。
3. 区分程序错误与命令错误：python todo.py done abc 会因为编号不是整数而失败，这是参数校验按预期工作，不一定是程序缺陷。
4. 缩小复现范围：先运行 list，再试添加一条短内容；不要同时改代码、换目录和改数据文件，否则难以判断变化的影响。
5. 检查数据文件：可以用文本编辑器查看 todos.json。若手工修改后 JSON 格式错误，程序会拒绝继续读取；重要数据应先复制备份。

遇到问题时，把执行的命令、完整错误信息、操作系统和 Python 版本一起记录下来。提问时说明预期结果和实际结果，并删去路径、用户名、令牌等个人或敏感信息。相比只说“代码不工作”，这些信息更能帮助别人复现问题。

六、入门者最常见的错误

错误一：花太多时间比较语言和工具

语言选择固然重要，但对第一个项目而言，能否持续练习、能否找到可信文档往往更关键。先选与目标相符的一门语言，完成一个小功能后再评估是否需要换路线。不要为了追求“最好的编辑器”停留在配置阶段。

错误二：只看视频，不独立敲代码

观看教程时，讲解者已经替你作出了判断。把示例合上，自己重写一遍，再改变需求，例如增加删除功能、拒绝空白内容或按完成状态筛选。遇到错误时先尝试理解信息，不要每次都直接复制答案。

错误三：项目目标太大

“做一个社交平台”包含账户、数据库、网络、权限和部署等大量问题，很难作为第一个项目。把目标缩到一周内能验证的最小版本：输入、处理、输出各有一个明确路径。先让基本流程可用，再逐项增加功能。

错误四：把“能运行”当成“可靠”

示例能完成基本演示，不代表覆盖了损坏文件、磁盘故障、多个进程同时写入等所有情况。项目越接近真实用户和重要数据，越需要测试、日志、备份、权限设计和部署维护。应明确自己尚未处理的边界，而不是因为没有报错就认为安全可靠。

错误五：复制代码，却不理解输入边界

命令行参数、用户输入、文件内容和网络请求都应按实际用途验证。参数类型转换只能检查能否转换，不能证明数据合理；输出到网页时还要做与上下文相符的编码，不能把这里的命令行示例直接当作网页输出方案。也不要把密码、访问令牌或个人信息提交到公开代码仓库。

错误六：一次加入太多依赖

第三方库可以节省工作，也可能带来安装、版本兼容和更新维护问题。本项目使用标准库是为了减少变量，并不意味着任何情况下都不该用库。确有需求时，阅读库的官方文档，确认维护状态、许可和适用版本；不要安装名字相似但来源不明的包。

七、用小步迭代练出项目能力

完成第一版后，不必马上重构成复杂架构。可以按次序加功能，每次只改一件事，并在改完后重新运行已有操作：

• 增加 delete <id>，先确认编号存在再删除，并保存文件。
• 增加只显示未完成事项的选项，练习列表筛选。
• 为每条记录增加创建时间，并思考旧版数据缺少该字段时如何兼容。
• 为函数编写自动化测试，检查空内容、错误编号和损坏 JSON 等情况。
• 把项目放入版本控制，记录每次可运行的改动；提交前检查是否包含私密数据。

做功能时先写下输入、预期输出和失败条件，再实现代码。例如“完成一个不存在的编号”应提示未找到，而不是悄悄新建记录。这样的思考能把需求转成可以验证的行为，也是从写练习题走向开发实际程序的关键一步。

八、给自学者的一条可执行路线

1. 第 1 阶段：建立运行习惯。安装一种语言和编辑器，能从终端运行一个文件，熟悉变量、条件、循环与函数。
2. 第 2 阶段：练习数据处理。用列表和字典处理输入，练习读写文件以及根据错误信息定位问题。
3. 第 3 阶段：完成一个最小项目。选一个与目标相关的小工具，先实现一条完整流程，再补充边界检查和说明。
4. 第 4 阶段：迭代和展示。增加一项功能、写基本测试、整理使用方法，并说明项目已知限制。展示作品时重点说明自己解决了什么问题、如何运行以及哪些部分还没实现。

学习速度因人而异，不必把固定周数当成合格线。比“连续看了多少小时教程”更有意义的指标是：能否自己运行程序、解释核心代码、根据报错修复问题，并把一个需求拆成几个可以验证的小步骤。

结语

自学编程不是一次性记住所有语法，而是逐步建立一套解决问题的方法：选定场景，挑合适的工具，把需求缩小，写出能运行的版本，观察结果并修正。本文的待办清单只是一项入门练习，但已经包含真实开发中常见的输入、数据保存和错误处理问题。

先把示例运行起来，再试着不看原代码重写，最后加一个自己的小功能。遇到问题时记录输入、预期和实际表现。能稳定完成这样的小循环，就已经踏上了从“学习编程”走向“用编程解决问题”的路。