第 2 章:目录、路径和「找不到文件」
本章目标:用
cd和mkdir在文件夹之间走动,分清相对路径和绝对路径,看懂并修好最常见的FileNotFoundError。
开篇:文件明明就在那儿
照着《大模型 API 调用》第 1 章写好了 weekly.py 和 notes.md,放在同一个文件夹里。双击打开都好好的,一运行却报:
FileNotFoundError: [Errno 2] No such file or directory: 'notes.md'文件明明就在那儿。问题不在文件,在你站在哪儿。这一章把「在哪儿」讲清楚。
学完这一章,你能:
- 用
cd、mkdir、ls建文件夹、走进走出 - 分清绝对路径和相对路径,知道
~、.、..各指什么 - 知道「找不到文件」最常见的原因,以及两种修法
2.1 给周报生成器建个家
本课的所有练习都放在用户文件夹下的 projects/weekly-report 里:
cd ~
mkdir projects
cd projects
mkdir weekly-report
cd weekly-report
pwdcd ~
mkdir projects
cd projects
mkdir weekly-report
cd weekly-report
pwd最后的 pwd 会显示你现在的位置:macOS 是 /Users/你的用户名/projects/weekly-report,Windows 是 C:\Users\你的用户名\projects\weekly-report。提示符里的「在哪」也会跟着变成 weekly-report。
| 命令 | 意思 |
|---|---|
cd 文件夹名 | 走进这个文件夹(change directory) |
cd .. | 退回上一层 |
cd ~ | 回到用户文件夹 |
mkdir 名字 | 新建一个文件夹(make directory) |
把 weekly.py 和 notes.md 放进这个文件夹。可以在文件夹窗口里拖进去,也可以用编辑器直接保存到这里。
打开当前文件夹的窗口
在终端里敲 open .(macOS)或 explorer .(Windows),会弹出当前所在文件夹的窗口,方便你拖文件进来。反过来,把文件夹窗口里的文件夹拖进终端,会自动粘贴它的完整路径。
2.2 绝对路径和相对路径
绝对路径从最顶层开始写,不管你站在哪都指同一个地方:
macOS: /Users/xiaoming/projects/weekly-report/notes.md
Windows: C:\Users\xiaoming\projects\weekly-report\notes.md相对路径从「你现在站的地方」出发:
| 你站在 | 写 notes.md 指的是 |
|---|---|
weekly-report 里 | weekly-report/notes.md,找得到 |
projects 里 | projects/notes.md,不存在 |
几个特殊写法:
| 写法 | 意思 |
|---|---|
~ | 用户文件夹 |
. | 当前文件夹 |
.. | 上一层文件夹 |
weekly-report/notes.md | 当前文件夹下的 weekly-report 里的 notes.md |
路径里有空格时,要用引号括起来:cd "My Projects"。所以建文件夹时,名字尽量别带空格和中文,用 weekly-report 这种写法最省事。
2.3 「找不到文件」是怎么来的
weekly.py 里读文件那一行写的是:
notes = Path("notes.md").read_text(encoding="utf-8")"notes.md" 是相对路径,相对的是你运行命令时站的位置,而不是 weekly.py 所在的位置。
在 weekly-report 里运行,一切正常(真实输出):
% python3 weekly.py
本周一共 3 条记录退到上一层 projects 再运行同一个文件:
% cd ..
% python3 weekly-report/weekly.py
Traceback (most recent call last):
File "/Users/xiaoming/projects/weekly-report/weekly.py", line 3, in <module>
notes = Path("notes.md").read_text(encoding="utf-8")
……
FileNotFoundError: [Errno 2] No such file or directory: 'notes.md'(路径换成了示意的用户名,中间几行省略。)脚本找到了,可脚本里的 notes.md 是从 projects 出发找的,那里没有这个文件。
用编辑器里的「运行」按钮、或者 AI 编程工具帮你运行时,它们站的位置不一定是你以为的那个文件夹,所以这个错误特别常见。
2.4 两种修法
修法一:先走进去再运行。 最简单,适合自己手动跑:
cd ~/projects/weekly-report
python3 weekly.py修法二:让脚本按自己的位置找文件。 适合要交给别人用、或者定时运行的脚本:
from pathlib import Path
HERE = Path(__file__).parent # weekly.py 自己所在的文件夹
notes = (HERE / "notes.md").read_text(encoding="utf-8")__file__ 是脚本自己的路径,.parent 是它所在的文件夹。这样不管从哪运行,都去脚本旁边找 notes.md。
2.5 再看几个常用的
| 想做什么 | macOS | Windows(PowerShell) |
|---|---|---|
| 看文件内容 | cat notes.md | cat notes.md |
| 复制文件 | cp notes.md notes-backup.md | cp notes.md notes-backup.md |
| 改名或移动 | mv old.md new.md | mv old.md new.md |
| 删除文件 | rm notes-backup.md | rm notes-backup.md |
PowerShell 为了照顾习惯,这几个名字都认。
rm 删除不进回收站
终端里 rm 删掉的文件不会进回收站,直接没了。删之前用 ls 确认一下名字,别对着文件夹用 rm -rf 这种你还不熟的写法。AI 编程工具请求执行 rm 时,也要看清楚它删的是什么(《AI Agent 科普》第 4 章讲过为什么)。
试一试
- [ ] 按 2.1 建好
~/projects/weekly-report,用open .或explorer .打开它 - [ ] 在
projects里运行python3 weekly-report/weekly.py,亲眼看一次FileNotFoundError,再用修法一修好 - [ ] 把
weekly.py改成修法二,再从projects运行一次
本章小结
| 要点 | 说明 |
|---|---|
| 走动 | cd 名字 进去、cd .. 退回、cd ~ 回家、mkdir 新建 |
| 绝对路径 | 从最顶层写起,在哪都一样 |
| 相对路径 | 从你现在站的地方算起 |
| 找不到文件 | 相对路径相对的是「运行时站的位置」,不是脚本的位置 |
| 两种修法 | 先 cd 进去再运行;或者脚本里用 Path(__file__).parent |
下一章预告
能在项目里运行脚本了,下一个拦路虎是 Key:
export设好了,关掉终端再开,又没了。还有python明明装了,终端却说找不到。下一章讲环境变量和 PATH。