04｜建立第一个 Python 项目目录

这套课程按知识依赖排列。本篇的前置知识是：第 03 篇。学完后，你应该能够理解当前目录并正确运行项目脚本。

本篇要解决的问题

本篇只处理“建立第一个 Python 项目目录”这一件事。示例基于 Python 3.14.6，在 macOS 环境核验；除明确标注的终端命令外，代码本身只使用 Python 标准能力。

先看清一个容易误解的细节

python3 hello.py 中的相对路径从终端当前目录开始查找。脚本明明存在却提示找不到时，先检查当前目录，而不是反复安装 Python。

核心概念

• 一个学习项目使用一个独立目录，代码和数据更容易管理。
• pwd 显示当前目录，ls 显示目录里的文件。
• 命令中的文件名必须与实际文件名一致，macOS 文件系统可能区分大小写。

跟着示例运行

在 macOS 终端执行：

mkdir python-study
cd python-study
pwd
printf 'print("项目已经运行")\n' > hello.py
python3 hello.py

预期结果：

项目已经运行

输出中包含环境路径、集合元素或日志格式时，具体文字和顺序可能随本机环境变化；判断是否成功应以本篇说明的关键结果为准。

按执行顺序拆开看

1. mkdir 创建目录，cd 改变终端当前目录，pwd 用来确认位置；这三步决定相对路径从哪里开始。
2. python3 hello.py 会在当前目录寻找 hello.py。若文件在别处，需要先切换目录或提供正确路径。

初学者容易混淆的地方

• 脚本存在却报找不到文件时反复安装 Python。此类问题通常先检查 pwd 和 ls。
• 项目目录和文件名混用空格、中文标点或不同大小写，导致复制命令时路径不一致。

练习

1. 新建 lesson01.py 并输出课程编号。
2. 先切换到上一级目录运行脚本，观察路径错误，再回到项目目录修正。

练习应先独立完成，再通过增加 print 输出或检查文件内容观察中间状态。当前课程尚未讲到的能力，不要求提前搜索复杂写法。

本篇边界

本篇目标是理解当前目录并正确运行项目脚本。没有展开的高级机制会放到后续课程；先确保能够解释示例中每一行代码，再进入下一篇。