跳到正文
零到全栈 · 卷 1 · 电脑与命令行直觉

文件、目录与路径

本合集目录
本章目录

单册说明:本文件是卷 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`。

下一步

路径会看了,接下来把"看"变成"操作":用终端建目录、复制、删除,并且知道每条命令危险在哪。

→ 卷1-02-终端另一种说话方式.md