Skip to content

第 2 章:目录、路径和「找不到文件」 ​

本章目标:用 cd 和 mkdir 在文件夹之间走动,分清相对路径和绝对路径,看懂并修好最常见的 FileNotFoundError。

开篇:文件明明就在那儿 ​

照着《大模型 API 调用》第 1 章写好了 weekly.py 和 notes.md,放在同一个文件夹里。双击打开都好好的,一运行却报:

text
FileNotFoundError: [Errno 2] No such file or directory: 'notes.md'

文件明明就在那儿。问题不在文件,在你站在哪儿。这一章把「在哪儿」讲清楚。

学完这一章,你能:

  • 用 cd、mkdir、ls 建文件夹、走进走出
  • 分清绝对路径和相对路径,知道 ~、.、.. 各指什么
  • 知道「找不到文件」最常见的原因,以及两种修法

2.1 给周报生成器建个家 ​

本课的所有练习都放在用户文件夹下的 projects/weekly-report 里:

bash
cd ~
mkdir projects
cd projects
mkdir weekly-report
cd weekly-report
pwd
powershell
cd ~
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 绝对路径和相对路径 ​

同一个 notes.md,从不同的位置出发,相对路径不一样;绝对路径从根开始,在哪都一样

绝对路径从最顶层开始写,不管你站在哪都指同一个地方:

text
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 里读文件那一行写的是:

python
notes = Path("notes.md").read_text(encoding="utf-8")

"notes.md" 是相对路径,相对的是你运行命令时站的位置,而不是 weekly.py 所在的位置。

在 weekly-report 里运行,一切正常(真实输出):

text
% python3 weekly.py
本周一共 3 条记录

退到上一层 projects 再运行同一个文件:

text
% 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 两种修法 ​

修法一:先走进去再运行。 最简单,适合自己手动跑:

bash
cd ~/projects/weekly-report
python3 weekly.py

修法二:让脚本按自己的位置找文件。 适合要交给别人用、或者定时运行的脚本:

python
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 再看几个常用的 ​

想做什么macOSWindows(PowerShell)
看文件内容cat notes.mdcat notes.md
复制文件cp notes.md notes-backup.mdcp notes.md notes-backup.md
改名或移动mv old.md new.mdmv old.md new.md
删除文件rm notes-backup.mdrm 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。

👉 第 3 章:环境变量和 PATH

本文阅读--次|全站访问--次|访客--人