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

编辑器与项目

本合集目录
本章目录

单册说明:本文件是卷 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,编辑器按别的编码读;或者你其实处在单文件模式,只搜了当前文件。逐个排除,先看搜索框下面那行"结果数 / 已排除文件数"。

下一步

工作台就位,接下来补一块最容易含糊的底层直觉:一个网址到底是怎样找到一台机器、又敲开某一扇门的。

→ 卷1-04-IP端口与DNS.md