编辑器与项目
本合集目录
本章目录
单册说明:本文件是卷 1 的第 3 章,可独立阅读。前置:第 2 章(终端常用命令)。本章讲清一个决定后面半年顺不顺的动作:用编辑器打开"文件夹",而不是打开"文件"。
| 项 | 内容 |
|---|---|
| 所属卷 | 卷 1 · 电脑与命令行直觉(第 3 / 6 章) |
| 前置章节 | 1.2 终端:另一种和电脑说话的方式 |
| 本章产出 | 一个以 ~/code/dudao 为根的工作区 + 一份项目级 settings.json + 可用的内嵌终端 |
| 对应代码 | .vscode/settings.json、占位 index.html(见 1.3.3) |
| 配图 | 无(后续统一制图) |
| 读完的判定 | 内嵌终端一打开就落在项目根,全局搜索能跨整个项目命中 |
1.3.1 一句话结论:编辑器的全部智能,都建立在"项目根"这个概念上
VS Code 不是"能高亮的记事本"。它的补全、跳转、全局搜索、Git 面板、内嵌终端,全都依赖同一个前提:你打开的是一个文件夹,它把这个文件夹当成项目根。
真实翻车:你双击 index.html 打开编辑,觉得一切正常。然后按 Ctrl+` 打开内嵌终端,敲 pwd:
C:\WINDOWS\system32
再敲 python serve.py:
python: can't open file 'C:\\WINDOWS\\system32\\serve.py': [Errno 2] No such file or directory
你以为是 Python 坏了。其实是编辑器在"单文件模式"下没有项目根,终端只能从进程默认目录启动。
那换成系统自带的记事本行不行?临时看一个文件可以。但它没有项目概念、没有行号、没有跨文件搜索,编码和换行还常常在你不知道的时候被改掉。你要的不是"更漂亮的记事本",而是一个知道项目边界的工具。
1.3.2 原理与方法
① 打开文件与打开文件夹,差的是整套上下文
| 维度 | 打开单个文件 | 打开文件夹 |
|---|---|---|
| 内嵌终端的起始目录 | 编辑器进程目录(Windows 常是 System32) |
项目根 |
| 全局搜索范围 | 只有当前文件 | 整个项目(可排除依赖目录) |
| 语言服务 | 单文件分析,读不到项目配置 | 读 pyproject.toml、jsconfig.json 等 |
| Git 面板 | 不显示 | 显示改动、分支、冲突 |
| 运行与调试 | 要手填绝对路径 | 默认以项目根为工作目录 |
| 新建文件的落点 | 每次都要选目录 | 默认落在侧边栏选中的目录 |
一句话:文件模式给你一个文本缓冲区,文件夹模式给你一个项目。
② 界面五个区域,各自负责什么
| 区域 | 位置 | 你主要用它做什么 |
|---|---|---|
| 活动栏 | 最左侧竖条 | 切换资源管理器、搜索、源代码管理、扩展 |
| 侧边栏 | 活动栏右侧 | 看文件树、搜索结果、Git 改动 |
| 编辑区 | 中间 | 写文件;可左右分屏对比 |
| 面板 | 底部 | 终端、问题、输出、调试控制台 |
| 状态栏 | 最底部 | 看编码、换行符、语言、Git 分支、错误数 |
状态栏是最容易被忽略的诊断工具。 文件乱码看编码,脚本在服务器跑不了看换行符,补全不工作看语言模式,Python 找不到包看解释器——四个高频问题,全在那一行小字里。
| 状态栏显示 | 含义 | 点开能改什么 |
|---|---|---|
UTF-8 / UTF-8 with BOM |
文件编码 | 换编码重新保存(BOM 要去掉) |
LF / CRLF |
换行符 | 切换行尾格式 |
HTML / Python |
语言模式 | 强制语法高亮与补全 |
Python 3.12 ('venv') |
当前解释器 | 选虚拟环境(卷 5 用) |
main* |
Git 分支与未提交状态 | 切换分支(卷 3 用) |
⊗ 0 △ 2 |
错误与警告数 | 打开"问题"面板 |
底部面板里的"问题"页会把语法错误、拼写提示、配置警告集中列出,点一条就跳到对应行。排查"为什么有红波浪线",先去这里看文字,不要盯着代码猜。
③ .vscode/ 目录:项目级配置
在项目根建一个 .vscode/,里面的文件跟着项目走:
| 文件 | 作用 | 该不该进版本库 |
|---|---|---|
settings.json |
项目级设置:格式化、排除目录、缩进 | 该,团队共享 |
extensions.json |
推荐扩展,别人打开会收到提示 | 该 |
launch.json |
调试配置 | 该,但别写个人绝对路径 |
tasks.json |
把常用命令固化成任务 | 该 |
| 主题、字号、键位 | 个人偏好 | 不该,放用户设置 |
判断标准很简单:换一个人来,这条设置还成立吗? 成立就放项目,不成立就放个人。
设置本身有三个作用域,优先级从低到高:用户(全局)、工作区(多根时)、当前文件夹。同一个键在三处都写了,最具体的那层赢。所以"我明明改了设置却没生效",第一步是确认你改的是哪一层,而不是反复重启编辑器。
④ 六个快捷键,覆盖八成操作
| 操作 | Windows / Linux | macOS |
|---|---|---|
| 按名字快速打开文件 | Ctrl+P |
Cmd+P |
| 命令面板(所有功能的入口) | Ctrl+Shift+P |
Cmd+Shift+P |
| 全项目搜索 | Ctrl+Shift+F |
Cmd+Shift+F |
| 打开/关闭内嵌终端 | Ctrl+` |
Cmd+` |
| 格式化整个文档 | Shift+Alt+F |
Shift+Option+F |
| 跳转到定义 | F12 |
F12 |
命令面板值得单独说:记不住快捷键时按 Ctrl+Shift+P,输 format、terminal、reload 都能找到对应命令。它是编辑器的搜索框,不是给高级用户准备的。
⑤ 保存即修:把规范交给机器
新手最容易把时间花在"缩进几个空格""行尾有没有空格"这种问题上。这些不该靠自觉,该让编辑器在保存时自动做掉:
{
"editor.formatOnSave": true,
"editor.tabSize": 2,
"files.trimTrailingWhitespace": true,
"files.insertFinalNewline": true,
"files.eol": "\n",
"files.autoSave": "afterDelay",
"search.exclude": {
"**/node_modules": true,
"**/dist": true
}
}
逐条的理由:
| 设置 | 解决什么 |
|---|---|
formatOnSave |
保存时自动排版,不用手工对齐 |
tabSize: 2 |
前端生态的默认缩进,减少无意义的 diff |
trimTrailingWhitespace |
去掉行尾空格,避免"只改了一个空格"的提交 |
insertFinalNewline |
文件末尾补换行,很多工具按行处理,缺了会报警 |
files.eol: "\n" |
统一用 LF。服务器是 Linux,CRLF 会让脚本直接跑不起来 |
autoSave: afterDelay |
停止输入后自动保存,减少"改了但没保存" |
search.exclude |
搜索不扫依赖和产物,结果才干净 |
files.eol 这条不是洁癖。Windows 默认 CRLF,Linux 认 LF。一个在 Windows 上写好的 .sh 脚本传到服务器,可能第一行就报错——原因见 1.3.4。
⑥ 内嵌终端的三个事实
第一,新开的终端默认落在项目根,这是"打开文件夹"的直接回报。
第二,每个终端是独立进程,在 A 终端 cd 不影响 B 终端。看到两个终端"目录不一样"不是 bug。
第三,关掉终端,里面跑的前台进程就没了。长任务要放 tmux,或者用编辑器的任务系统,这是第 5 章的事。
⑦ "工作区"是什么,什么时候才需要多个根
VS Code 说的"工作区"(workspace),就是你当前这个窗口打开的一个或多个文件夹的集合。打开一个文件夹时,工作区就等于那个文件夹;打开多个时,可以存成一个 .code-workspace 文件,记住每个根的路径和共享设置。
学习阶段,一个项目一个窗口最省心。等到前端和后端拆成两个仓库、又需要跨目录搜索和调试时,再用多根工作区。提前上多根,只会让搜索范围和终端目录变得更难判断。
也不要图省事直接打开整个家目录:搜索会扫到几万个无关文件,Git 面板可能把整个家目录当成仓库,误操作的面积太大。窗口的边界,就是你操作的边界。
1.3.3 动手:打开 ~/code/dudao,用内嵌终端跑一条命令
第一步,用"打开文件夹"的方式进来。菜单 File → Open Folder,选中 dudao。不要选里面的某个文件。
更快的办法是在终端里进到项目目录再执行:
cd ~/code/dudao
code .
. 就是"当前目录"。如果提示 code: command not found,在 VS Code 里按 Ctrl+Shift+P,执行 Shell Command: Install 'code' command in PATH,然后重开终端。
第二步,确认根目录对了。侧边栏顶部应该显示 DUDAO,展开后能看到 backend、frontend、notes 三个目录。
第三步,建项目配置。新建 .vscode/settings.json,写入 1.3.2 ⑤ 那段 JSON。保存后状态栏右下角应该出现 LF(不是 CRLF)。
第四步,建一个占位首页。这一章不教 HTML,只验证文件能被创建、保存、搜索到;真正的页面结构在卷 2。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>读到</title>
</head>
<body>
<h1>读到</h1>
<p>占位页。卷 2 会把它改成真正的页面。</p>
</body>
</html>
第五步,打开内嵌终端,按 Ctrl+`,然后跑三条:
pwd
ls -la
code --version
预期:
/home/lin/code/dudao
total 20
drwxr-xr-x 5 lin lin 4096 Nov 17 01:40 .
drwxr-xr-x 3 lin lin 4096 Nov 17 01:36 ..
drwxr-xr-x 2 lin lin 4096 Nov 17 01:40 .vscode
drwxr-xr-x 2 lin lin 4096 Nov 17 01:36 backend
drwxr-xr-x 2 lin lin 4096 Nov 17 01:36 frontend
-rw-r--r-- 1 lin lin 198 Nov 17 01:40 index.html
drwxr-xr-x 2 lin lin 4096 Nov 17 01:38 notes
1.105.1
b1c0a0d1e2f3a4b5c6d7e8f90123456789abcdef
x64
pwd 那一行是关键证据:它必须是项目根,不能是 System32,也不能是家目录。 不是就说明你还在单文件模式。Windows 上这一行形如 /c/Users/lin/code/dudao,同样以 code/dudao 结尾。
第六步,验证全局搜索。按 Ctrl+Shift+F,搜 占位页。结果里应该出现 index.html,并且显示行号和上下文。再搜 第 1 天,应该命中第 2 章建的 notes/day01.md。
第七步,验证"保存即修"。在 index.html 某行末尾故意敲三个空格,等两秒(自动保存已开),看它们是否被自动删掉。没有生效就检查 settings.json 有没有写错层级,以及右下角有没有报配置错误。
自证清单:
| 检查项 | 怎么验 | 通过标准 |
|---|---|---|
| 打开的是文件夹 | 侧边栏根部名称 | 显示 dudao,不是单个文件名 |
| 终端在项目根 | pwd |
输出以 /code/dudao 结尾 |
| 项目配置生效 | 状态栏换行符 | 显示 LF |
| 全局搜索可用 | Ctrl+Shift+F 搜 占位页 |
命中 index.html |
| 自动保存可用 | 改一行等两秒 | 标签页没有未保存圆点 |
1.3.4 三个坑
坑 1:用"打开文件"的方式打开,终端落在 System32
症状:内嵌终端 pwd 输出 C:\WINDOWS\system32;运行 python serve.py 报 can't open file 'C:\\WINDOWS\\system32\\serve.py';全局搜索只搜当前文件;Git 面板空白。
成因:单文件模式没有工作区根,编辑器无法决定"项目"从哪里开始。Windows 上从开始菜单启动的进程,默认目录常常就是 System32。
修法:关掉当前窗口,用 File → Open Folder 重新打开 dudao;或者在项目目录里执行 code .。判断是否修好,只看一条:新开的内嵌终端 pwd 是不是项目根。
坑 2:CRLF 与 BOM,脚本传到服务器就跑不了
症状:本机写好的脚本,上传到服务器执行:
bash: ./deploy.sh: /usr/bin/env: bad interpreter: No such file or directory
或者:
bash: $'\357\273\277#!/bin/bash': command not found
成因:第一种是 Windows 的 CRLF 换行。Linux 把行尾的 \r 当成命令的一部分,于是去找一个名字里带 \r 的解释器。第二种是文件开头有 UTF-8 BOM(字节 EF BB BF),shell 把这三个字节当成了命令名。记事本"另存为 UTF-8"有时就会加 BOM。
修法:看状态栏,点 CRLF 改成 LF;settings.json 里设 files.eol: "\n"。已经坏掉的文件在服务器上执行 sed -i 's/\r$//' deploy.sh,或者装 dos2unix 处理。BOM 用 sed -i '1s/^\xEF\xBB\xBF//' 文件 去掉,或者用编辑器的"以 UTF-8 无 BOM 保存"。
判断文件到底有没有问题,让系统告诉你,别用眼睛猜:
file deploy.sh
正常输出形如 deploy.sh: Bourne-Again shell script, ASCII text executable;带 CRLF 的会明确写 ASCII text, with CRLF line terminators。
坑 3:以为保存了,其实运行的是旧文件
症状:编辑器里明明改了,终端跑出来还是旧结果;标签页文件名旁边有一个小圆点;重新执行命令也没变化。
成因:自动保存没开,Ctrl+S 又没按。或者你开了两个窗口,改的是另一份副本。编辑器不会阻止你运行未保存的文件。
修法:settings.json 里开 "files.autoSave": "afterDelay";看标签页的圆点判断是否未保存;跑命令前瞄一眼状态栏。更彻底的办法是养成"改完按 Ctrl+S"的肌肉记忆——自动保存也会有延迟窗口。
还有一个隐蔽来源:你同时开着两个窗口,改的是另一份副本。这时不靠眼睛,让系统报时间:
stat -c '%y %n' index.html
macOS 上用 stat -f '%Sm %N' index.html。输出里的修改时间和你以为的不一致,就是改错了文件或没保存。
| 坑 | 症状关键词 | 一句话修法 |
|---|---|---|
| 单文件模式 | System32、只搜当前文件 |
重新"打开文件夹" |
| CRLF / BOM | bad interpreter、$'\357\273\277#!' |
状态栏改 LF,存无 BOM |
| 未保存就运行 | 结果与代码不符、标签页有圆点 | 开自动保存,改完按 Ctrl+S |
本章验收
- 侧边栏根部显示的是文件夹名,不是某个文件名
- 新开内嵌终端,
pwd落在项目根 -
.vscode/settings.json生效,状态栏换行符是LF - 全局搜索能在整个项目里命中一个词,并显示行号
- 能说出 CRLF 导致
bad interpreter的原因 - 能解释为什么个人主题不该写进项目配置
自测
Q1:为什么"内嵌终端的当前目录"能证明你打开的是文件夹?
看答案
因为终端进程的初始工作目录由编辑器决定。打开文件夹时,编辑器知道项目根,会把根目录传给终端;单文件模式没有根,只能继承编辑器进程的默认目录,Windows 上常见就是 `System32`。所以 `pwd` 是一条成本极低、结论极硬的检查。Q2:files.eol 为什么要设成 \n,而不是跟随系统?
看答案
因为代码最终要跑在 Linux 服务器上。Windows 的 CRLF 会让 shell 脚本、某些配置文件在 Linux 上解析失败,报错还很难懂(`bad interpreter`)。统一成 LF 后,本机和服务器看到的是同一份字节,少一类只在部署时出现的故障。Q3:全局搜索搜不到一个你确定存在的词,可能是什么原因?
看答案
常见四种:搜索范围被 `search.exclude` 排除了(`node_modules`、`dist`);开了大小写敏感或全词匹配;文件编码不是 UTF-8,编辑器按别的编码读;或者你其实处在单文件模式,只搜了当前文件。逐个排除,先看搜索框下面那行"结果数 / 已排除文件数"。下一步
工作台就位,接下来补一块最容易含糊的底层直觉:一个网址到底是怎样找到一台机器、又敲开某一扇门的。