文件、目录与路径
本合集目录
本章目录
单册说明:本文件是卷 1 的第 1 章,可独立阅读。前置:卷 0 第 4 章(环境与目录约定)。本章解决"文件明明在这儿,电脑却说找不到"这类最耗时间的问题——路径。
| 项 | 内容 |
|---|---|
| 所属卷 | 卷 1 · 电脑与命令行直觉(第 1 / 6 章) |
| 前置章节 | 0.4 课前准备:机器、工具、账号 |
| 本章产出 | 一套能自己讲清楚的路径判断法 + 一次"家目录 ↔ 项目目录"的往返记录 |
| 对应代码 | 命令清单(见 1.1.3),不需要额外文件 |
| 配图 | 无(后续统一制图) |
| 读完的判定 | 随便给你一个路径,你能立刻说出它是绝对还是相对、指向哪里、换个目录会不会失效 |
1.1.1 一句话结论:路径不是文件名,是"从哪儿走到哪儿"的完整路线
你在终端里敲下 python code/serve.py,得到这样一行:
python: can't open file 'C:\\Users\\lin\\code\\serve.py': [Errno 2] No such file or directory
文件真的存在,在 ~/code/dudao/code/ 下面。但你现在站在家目录,敲的是 code/serve.py,于是它去 ~/code/serve.py 找——那里没有,报错。可电脑不猜,它只按你给的路线走:从当前目录出发,找 code/serve.py。
这一类错误占了新手求助的很大一部分,而它跟代码一个字都没关系。 本章只干一件事:让你看到任何路径,脑子里能立刻画出一条路线。
电脑为什么不猜?因为同名文件可以有很多个。每一层目录下都能放一个 index.html,硬盘上可能有几百个。让它"帮我找一下",等于让它遍历整块盘:慢、结果不确定,还可能翻出系统目录里的同名文件。所以所有工具都遵守同一条规则——你给路线,它照着走;走不到,就报错。
1.1.2 原理与方法
① 目录是一棵树,根只有一个
Linux 和 macOS 只有一个根,写作 /。所有东西都挂在它下面:/home、/etc、/var、/usr。
Windows 是"一片森林":每个盘符 C:\、D:\ 都是自己的一棵树。这是历史遗留,不是设计优势。
路径用分隔符分层。Windows 传统上用反斜杠 \,Linux 用正斜杠 /。现在的 Windows 和 PowerShell 也认 /,而 Git Bash 里盘符写成 /c/。
| 同一个位置 | 写法 | 谁认 |
|---|---|---|
| Linux / macOS | /home/lin/code/dudao |
全部工具 |
| Windows 资源管理器 | C:\Users\lin\code\dudao |
资源管理器、cmd |
| Windows PowerShell | C:/Users/lin/code/dudao |
PowerShell、多数现代工具 |
| Windows Git Bash | /c/Users/lin/code/dudao |
Git Bash 及其启动的程序 |
四行指的是同一个文件夹。写法不同不代表文件不同——这也是为什么"我明明有这个文件"和"系统说没有"能同时成立。
② 家目录:唯一一个能用 ~ 表示的地方
家目录是系统分给你的私人目录,你的桌面、文档、下载、配置文件都在里面。
| 系统 | 家目录的真实路径 | ~ 展开成 |
|---|---|---|
| Linux | /home/lin |
/home/lin |
| macOS | /Users/lin |
/Users/lin |
| Windows | C:\Users\lin |
C:\Users\lin |
~ 由 shell 展开,不是文件系统的一部分。所以它在终端里好用,在资源管理器地址栏里不认。几乎所有开发工具的配置都藏在家目录下的隐藏目录里:~/.ssh(密钥)、~/.gitconfig(Git 身份)、~/.vscode(编辑器配置)。
判断:写脚本、写配置、写定时任务时,不要写死 /home/lin。换一台机器、换一个用户名,它立刻失效。用 ~ 或环境变量 $HOME。
③ 绝对路径与相对路径:判据只有一条
以根或盘符开头的,是绝对路径;否则是相对路径。 相对路径相对的那个东西,叫"当前工作目录"(current working directory,简称 cwd)——就是你现在"站"在哪个文件夹里。
一条路径可以拆成三段:/var/www/dudao/index.html 里,/var/www/dudao/ 是目录部分,index 是主名,.html 是扩展名。改名、移动、配 Nginx 的 root,动的是不同段,别混为一谈。
在 /home/lin/code/dudao 下,几种写法指向哪里:
| 写法 | 实际指向 | 类型 |
|---|---|---|
/var/www |
/var/www |
绝对 |
notes |
/home/lin/code/dudao/notes |
相对 |
./notes/day01.md |
/home/lin/code/dudao/notes/day01.md |
相对 |
../backend |
/home/lin/code/backend |
相对 |
~/code |
/home/lin/code |
绝对(~ 先展开) |
. 是"当前这一级",.. 是"上一级"。这两个符号在任何系统上都通用。
关键差别:相对路径会随"你在哪"而变,绝对路径不会。 所以有一个反直觉的事实——脚本里的相对路径,参照的不是脚本所在目录,而是启动脚本时你所在的目录。同一条 python code/serve.py,在家目录跑和在项目根跑,结果不同。
"在哪"这件事有三个不同的基准,混起来就是灾难:
| 你在哪写路径 | 基准是谁 | 典型翻车 |
|---|---|---|
| 终端里手敲 | 当前目录(pwd 说了算) |
忘了先 cd,命令在别处执行 |
| 脚本文件里 | 启动脚本时的当前目录 | 以为基准是脚本自己所在的目录 |
| 服务配置里(Nginx、systemd) | 通常固定为 / 或配置显式指定 |
写相对路径,服务启动后找不到文件 |
第三条是后面几卷的常客。服务不是人,它没有"我现在站在哪"的概念,所以配置里一律写绝对路径。
还有一个新手常问的细节:为什么执行自己写的脚本要写 ./deploy.sh,不能直接敲 deploy.sh?因为 shell 只在 PATH 列出的目录里找命令,当前目录通常不在其中。./ 等于告诉它"就在当前目录找这个文件"。这同时是一条安全设计:防止你无意中执行了别人丢在当前目录里的同名程序。
怎么快速拿到可靠的绝对路径:
| 想要 | 怎么做 |
|---|---|
| 当前目录的绝对路径 | pwd |
| 把相对路径翻译成绝对路径 | realpath notes/day01.md |
| 解析符号链接后的真实路径 | readlink -f link |
| PowerShell 里取绝对路径 | (Resolve-Path .\notes).Path |
| 懒得手打 | 把文件从资源管理器拖进终端,路径会自动粘贴 |
realpath 在 Linux 和较新的 macOS 上自带;Git Bash 里若提示找不到,用 readlink -f 代替,效果一样。
④ 扩展名不是身份,只是标签
Windows 用扩展名决定"双击用什么程序打开";Linux 基本不看扩展名,它读文件开头几个字节判断真实类型。
| 谁在判断 | 依据 | 例子 |
|---|---|---|
| 资源管理器双击 | 扩展名 → 注册表关联 | .txt 用记事本 |
Linux 的 file 命令 |
文件头部的特征字节 | PNG 开头是 89 50 4E 47 |
| Nginx 返回 Content-Type | 扩展名 → mime.types |
.css → text/css |
三件事要分清楚:
- 把
report.txt改名成report.html,内容一个字节没变。浏览器打开它,看到的还是纯文字,因为没有标签结构。 README、Makefile、.gitignore没有扩展名,仍然是标准的文本文件,工具照读不误。- 但 Nginx 确实看扩展名决定
Content-Type。所以"扩展名不是身份"不等于"扩展名没用"——它是给工具看的标签。
一句话:改扩展名只改变别人怎么对待它,不改变它是什么。
⑤ 路径里那些看不见的坑
第一样是隐藏文件。以 . 开头的文件和目录,ls 默认不显示,要 ls -a。.env、.git、.ssh 都属于这类,它们不是"系统文件",只是约定俗成的隐藏。
第二样是符号链接。ls -l 输出里带 -> 的,是一个指向别处的"快捷方式":
lrwxrwxrwx 1 root root 24 Nov 17 01:20 default -> /etc/nginx/sites-available/default
开头那个 l 就表示链接。rm 删的是链接本身,不是它指向的目标;但删之前还是先 ls -l 看清楚它指向哪里,别把"删快捷方式"当成"删目录"。
第三样是大小写。Linux 区分 Index.html 和 index.html,Windows 和 macOS 默认不区分(macOS 的磁盘格式通常不区分)。同一份文件,在你电脑上能打开,在服务器上 404,九成是大小写。
还有一条与长度有关的限制:Windows 传统接口有 260 字符的路径上限,层数一多就会报 [WinError 206](文件名或扩展名太长),Linux 上对应的报错是 File name too long。把项目放在 C:\code\ 这类浅目录,能顺带避开它。
1.1.3 动手:从家目录走到项目目录,再走回来
全程只用一个动作自证:pwd(print working directory,打印当前工作目录)。它永远说实话。Windows 读者请在 Git Bash 里做这一节,PowerShell 的等价命令第 2 章有对照表。
先回到家的位置:
cd ~
pwd
如果你这会儿在 PowerShell 里,这两条等价:
Set-Location $HOME
Get-Location
预期输出就是你的家目录:Linux 形如 /home/lin,Windows Git Bash 形如 /c/Users/lin。看到这个,说明你站对了。
建目录、进去、再退出来:
mkdir -p ~/code/dudao/notes
cd ~/code/dudao
pwd
ls -la
cd notes
pwd
cd ..
pwd
cd ~
pwd
逐条对照,任何一步不符就停下来查,不要往下走(下表以 Linux 为例,Windows 把 /home/lin 读成 /c/Users/lin):
| 你敲的 | 应该看到 | 证明了什么 |
|---|---|---|
cd ~ → pwd |
/home/lin |
~ 展开成家目录 |
cd ~/code/dudao → pwd |
/home/lin/code/dudao |
绝对路径与位置无关 |
cd notes → pwd |
/home/lin/code/dudao/notes |
相对路径基于当前目录 |
cd .. → pwd |
/home/lin/code/dudao |
.. 是上一级 |
cd ~ → pwd |
回到 /home/lin |
一条命令回家 |
再验证"相对路径会失效"这件事。在项目根执行:
cd ~/code/dudao
ls notes
cd /tmp
ls notes
第二条会报:
ls: cannot access 'notes': No such file or directory
文件没丢,只是你现在站在 /tmp。这就是 1.1.1 那个报错的全部真相。
再做一次反向验证:把相对路径交给系统翻译,看看它算出来的结果和你想的是不是同一个地方。
cd ~/code/dudao
realpath notes
输出形如 /home/lin/code/dudao/notes。如果 Git Bash 提示 realpath: command not found,改用 readlink -f notes,结果相同。从这一刻起,"我觉得"变成"系统确认"。
最后用 cd - 在两个目录之间来回跳。- 代表"上一个目录":
cd ~/code/dudao
cd /var
cd -
pwd
pwd 会回到 /home/lin/code/dudao(或你的对应路径)。cd - 在做部署、来回核对两个目录时非常省事。
Windows 用户额外做一次对照:在 PowerShell 里分别执行 Set-Location C:\Users\lin\code\dudao 和 Set-Location C:/Users/lin/code/dudao,两次都能成功。这说明正斜杠在 Windows 上可用;但反过来,反斜杠在 Git Bash 里是转义符,混着用容易把路径里的字符吃掉。
1.1.4 三个坑
坑 1:路径里有中文
症状:程序说找不到文件,但路径里的中文在报错里变成乱码,比如 C:\Users\寮犱笁\Desktop\notes.txt;或者 Python 直接抛 UnicodeDecodeError: 'gbk' codec can't decode byte 0x80 in position 12。
成因:三层编码不一致——Windows 的系统区域设置可能是 GBK,终端是 UTF-8,程序内部又按 UTF-8 处理。一个中文路径从这层传到那层,解一次码就坏了。工具链里只要有一个环节没处理好,报错就会伪装成"文件不存在"。
修法:项目放在纯英文路径下,比如 C:\code\dudao 或 ~/code/dudao。已经建在中文目录里的,用 mv 整体搬走,别在原名上反复试。Windows 有一个"使用 Unicode UTF-8 提供全球语言支持"的开关,但它会让一些老软件显示乱码,学习阶段不值得为此改系统设置。
判断:终端里 pwd,输出里出现汉字,就是风险。更严格一点的判据:一个"安全"的路径里只应该有字母、数字、-、_、.、/,出现别的字符就考虑搬走。
坑 2:路径里有空格
症状:
bash: cd: /c/Program: No such file or directory
或者 Windows 的 cmd:
'C:\Program' 不是内部或外部命令,也不是可运行的程序或批处理文件。
成因:空格在 shell 里是参数分隔符。cd /c/Program Files 被拆成"cd 到 /c/Program"和"多一个参数 Files",前者当然不存在。
修法:加引号 cd "/c/Program Files",或用反斜杠转义 cd /c/Program\ Files。根本办法还是别把项目放在带空格的路径里。写脚本时变量一律加引号:cp "$SRC" "$DST",这条习惯能挡掉以后一大半莫名其妙的错。PowerShell 里调用带空格的程序要多一个调用运算符:& "C:\Program Files\App\app.exe",直接敲路径会被当成字符串。
坑 3:隐藏了扩展名,文件名变成 index.html.txt
症状:资源管理器里文件叫 index.html,终端 ls 却显示 index.html.txt;用浏览器打开,页面显示的是源码;放到 Nginx 后面,响应头是 Content-Type: text/plain。
成因:Windows 资源管理器默认勾选"隐藏已知文件类型的扩展名"。你新建一个文本文件,系统自动补 .txt,你再手打 .html,于是完整名字成了 index.html.txt,而资源管理器只显示前面那段。
修法:资源管理器 → 查看 → 勾选"文件扩展名",先让真相可见;然后用 ls -la 或 dir 复核;重命名时把最后的 .txt 删掉。判断口诀:任何"我写的是网页,浏览器却显示源码",第一件事看真实文件名。
| 坑 | 报错关键词 | 一句话修法 |
|---|---|---|
| 中文路径 | 乱码路径、UnicodeDecodeError、No such file |
项目搬到纯英文路径 |
| 空格路径 | 路径被截成两段、'C:\Program' 不是内部或外部命令 |
加引号,或换无空格路径 |
| 隐藏扩展名 | 实际是 xxx.html.txt、text/plain |
打开"显示扩展名"再改名 |
本章验收
- 不看笔记能说出绝对路径和相对路径的唯一判据
- 能在终端里从家目录走到
~/code/dudao,再回到家的,每一步用pwd自证 - 能解释为什么把
.txt改成.html不会让文本变成网页 - 能说出中文路径、空格路径、隐藏扩展名各自的一个真实报错
- 自己的项目路径满足"纯英文、无空格"
自测
Q1:路径 ../assets/logo.png 在什么情况下会指向错误的位置?
看答案
它是相对路径,基准是当前工作目录。只要 cwd 变了,它指向的位置就变了。最典型的翻车是脚本里写相对路径:你在项目根执行脚本时它指向 `项目根/../assets`,换到别处执行就指到另一个盘。修法是脚本里用绝对路径,或者开头先 `cd "$(dirname "$0")"` 切到脚本所在目录。Q2:把 report.txt 改名成 report.html,浏览器打开看到的是源码。为什么?
看答案
因为文件内容仍然是纯文本,没有任何 HTML 标签。浏览器按 HTML 解析时,没有标签的文字会被当作文本节点显示出来。扩展名只影响"谁来打开、按什么类型返回",不影响内容本身。真正的 HTML 需要结构标签,这是卷 2 的内容。Q3:为什么 cd ~ 在三个系统都能用,而 cd /home/you 不行?
看答案
`~` 由 shell 展开成"当前用户的家目录",具体路径由系统决定,所以跨系统有效。`/home/you` 是 Linux 的固定约定;macOS 是 `/Users/you`,Windows 是 `C:\Users\you`。把家目录写死在脚本里,换一台机器就会报 `No such file or directory`。下一步
路径会看了,接下来把"看"变成"操作":用终端建目录、复制、删除,并且知道每条命令危险在哪。