w wyl123ly 的博客
MD

工具-06-编辑器与IDE

52 KB 2026.10.11 原文件

工具-06-编辑器与IDE

这篇笔记讲什么

工具不该成为学习的障碍,但也不该成为瓶颈。本篇讲清编辑器(editor)与集成开发环境(IDE)的区别与选择,把 VS Code 从安装、中文界面、必装插件、必学快捷键、settings.json / keybindings.json 配置、.vscode/ 是否入库、多根工作区、远程开发(Remote-SSH / Dev Containers / WSL)讲到 Visual Studio、Rider、PyCharm、WebStorm 的定位差异,再补上服务器必备的 vi/vim 生存指令集、.editorconfig 跨编辑器统一风格、字体主题、代码片段与终端分屏实践。

一条前置建议:学习期不要折腾配置。先用默认配置写够 1000 行代码,再按痛点改配置。

是什么

概念英文本质典型代表
文本编辑器text editor以「编辑文本」为核心,靠插件扩展出代码能力VS Code、Sublime Text、Neovim、Vim
集成开发环境integrated development environment (IDE)编辑器 + 编译器/解释器 + 调试器 + 项目模型 + 重构 + 剖析器,开箱一体Visual Studio、IntelliJ IDEA、PyCharm、Rider、Eclipse
语言服务器language server通过 LSP(Language Server Protocol)为编辑器提供补全、跳转、诊断Pylance、rust-analyzer、TypeScript Language Server
调试适配器debug adapter通过 DAP 为编辑器提供断点调试能力debugpy、vscode-js-debug、netcoredbg

一句话区分:

  • 编辑器是「一个很强的文本编辑器 + 可选的代码能力」;
  • IDE 是「一个为某语言/平台量身定制的完整工作台」。

二者的边界正在消失

VS Code 装上 Pylance + debugpy + Ruff 之后,对 Python 的能力已接近轻量 IDE;而 Visual Studio 2022 也提供了「轻量模式」。选择时不要纠结名分,关注你要做的事需要哪些能力。

为什么需要它

选错工具的代价

场景用错工具后果
学习 C# / .NET用记事本 + dotnet build没有智能补全,看不清 API 签名,学习曲线陡增一倍
快速改服务器上一个配置文件打开 IDE传输整个项目、索引五分钟,只为改一行
前端 + Markdown + 脚本混合开发用重型 IDE启动慢、内存高、插件生态不如 VS Code
大型 C# 解决方案(数百项目)用 VS Code项目模型弱,重构与解决方案级分析不如 Visual Studio / Rider

但更重要的是:不要在学习期折腾配置

这是本篇最重要的一条建议。

新手常走的弯路(真实时间账):
  第 1 天:装 VS Code,研究字体、主题、图标包              → 3 小时
  第 2 天:抄一份 800 行配置,其中一半的键已经改名/失效       → 2 小时(且开始报错)
  第 3 天:折腾 Neovim,配置 LSP、补全、telescope            → 8 小时
  第 4 天:配置坏了,回退到 VS Code 默认配置                  → 1 小时
  ─────────────────────────────────────────────────
  合计 14 小时,代码写了 0 行。

正确顺序:

  1. 用默认配置开始写代码;
  2. 遇到具体重复劳动时(比如每次都要手敲同一个模板),再去搜对应的配置项;
  3. 配置改动一行一行加,加完立刻验证;
  4. 把配置纳入 Git(见下文),换机器时能一键恢复。

何时才值得投入时间学工具

当重复操作的频率 × 单次耗时已经明显影响产出时。例如每天提交 20 次 Git、每次都要手敲五条命令,就值得花两小时学 GitLens 与命令面板。反之,一年用一次的功能不值得装插件。

核心内容

VS Code:为什么成为主流

原因说明
免费且跨平台Windows / macOS / Linux 同一套体验,配置可同步
启动快、资源占用中等冷启动通常 1~3 秒;比完整 IDE 轻,比 Vim 重
插件生态最大几乎所有语言都有官方或高质量扩展
LSP / DAP 标准化的受益者一种语言的服务器写好,所有装了对应扩展的人都能用
基于 Web 技术Electron + TypeScript,社区能快速贡献扩展与主题
远程开发能力强Remote-SSH、Dev Containers、WSL、Tunnels(见下文)
内置 Git、终端、调试、测试日常开发不必频繁切窗口
安装与中文界面
  1. 到官网下载对应平台安装包(Windows 建议选 User Installer,避免权限问题);
  2. Windows 安装时建议勾选:
  • 「添加到 PATH」(这样终端里可直接 code . 打开当前目录);
  • 「将『通过 Code 打开』添加到资源管理器目录上下文菜单」(右键即开);
  1. 切换中文界面:安装扩展 Chinese (Simplified) Language Pack for Visual Studio Code,然后:
  • 按 Ctrl+Shift+P 打开命令面板;
  • 输入并执行 Configure Display Language;
  • 选择 zh-cn,按提示重启。

命令面板是 VS Code 的「万能入口」

你能在菜单里点到的功能,几乎都能在 Ctrl+Shift+P 里搜到。忘记快捷键时不要翻菜单,直接搜命令名。这是 VS Code 最重要的一个使用习惯。

官方文档把「命令面板」「快速打开」「多光标」「跳转定义」等列为 Tips and Tricks 的核心内容,值得完整读一遍。

必装插件清单

插件是「能力」不是「收藏」

每装一个插件都会增加启动时间与冲突面。原则:按语言装一套,装完立刻用上,用不上就卸。

通用(所有项目)

插件ID作用
Error Lensusernamehw.errorlens把诊断信息直接显示在行尾,不用把鼠标悬停上去
GitLenseamodio.gitlens行级 blame、提交历史、分支对比,理解代码来历必备
Path Intellisensechristian-kohler.path-intellisense路径自动补全,写 import / src= 时省心
Prettier - Code formatteresbenp.prettier-vscode统一格式化 JS/TS/CSS/Markdown/JSON
ESLintdbaeumer.vscode-eslintJS/TS 静态检查,问题在编辑期就暴露
EditorConfig for VS CodeEditorConfig.EditorConfig让 .editorconfig 生效(跨编辑器统一风格)
Code Spell Checkerstreetsidesoftware.code-spell-checker拼写检查(含中文词库可选)
Git Graphmhutchie.git-graph图形化分支图,理解分支拓扑直观

Python

插件ID作用
Pylancems-python.vscode-pylance类型推断、补全、跳转、内联类型提示(基于 Pyright)
Pythonms-python.python解释器选择、虚拟环境、调试、测试集成
Ruffcharliermarsh.ruff极快的 linter + formatter(替代 flake8/isort/black 组合)
Jupyterms-toolsai.jupyter.ipynb 与交互式窗口

C# / .NET

插件ID作用
C# Dev Kitms-dotnettools.csdevkit解决方案资源管理器、测试、调试的一体化体验(含 C# 扩展)
C#ms-dotnettools.csharp语言服务(被 Dev Kit 依赖)
.NET Install Toolms-dotnettools.vscode-dotnet-runtime管理 .NET 运行时/SDK

大型 C# 解决方案的取舍

项目数很多、依赖复杂、需要强大的重构与性能剖析时,Visual Studio 或 Rider 明显更合适;VS Code 的 C# Dev Kit 适合中小项目与跨语言工作区。详见下文。

前端

插件ID作用
Vue - OfficialVue.volarVue 3 SFC 的语言支持(Vue 2 需另配 Vetur)
Tailwind CSS IntelliSensebradlc.vscode-tailwindcss类名补全、悬停预览实际样式
TypeScript Vue PluginVue.vscode-typescript-vue-plugin让 TS 在 .vue 中正确工作
Auto Rename Tagformulahendry.auto-rename-tag改开标签自动改闭标签
CSS Peekpranaygp.vscode-css-peek从 class 直接跳到样式定义

Markdown(写本笔记库必备)

插件ID作用
Markdown All in Oneyzhang.markdown-all-in-one目录生成、快捷键加粗/列表、表格格式化、预览增强
markdownlintDavidAnson.vscode-markdownlint检查 Markdown 风格问题
Markdown Preview Enhancedshd101wyy.markdown-preview-enhanced更强的预览(支持图表、导出)
Foam / Obsidian 相关扩展—双链与知识库导航(Obsidian 用户一般直接在 Obsidian 里写)
必学快捷键表

以下为 Windows / Linux 键位(macOS 把 Ctrl 换成 Cmd,Alt 换成 Option):

快捷键功能为什么重要
Ctrl+Shift+P命令面板万能入口,忘记快捷键时就用它
Ctrl+P快速打开文件按文件名跳转,比在侧栏翻快十倍
Ctrl+P 后输入 @跳转到当前文件的符号大文件内导航
Ctrl+P 后输入 #全工作区搜索符号找函数/类定义
Ctrl+Shift+F全工作区搜索文本改名前先看影响面
Ctrl+Shift+E / Ctrl+Shift+G资源管理器 / 源代码管理最常用的两个侧栏
Ctrl+ ``打开/关闭集成终端少切窗口
F2重命名符号跨文件安全重命名,不要用查找替换
Ctrl+D选中下一个相同词批量改局部变量(比全局替换安全)
Ctrl+Shift+L选中全部相同词谨慎使用,范围是全文件
Alt+点击多光标多处同时编辑
Ctrl+Alt+↓ / Ctrl+Alt+↑向下/向上添加光标列编辑
Shift+Alt+↓向下复制当前行写相似代码块时最省事
Alt+↓ / Alt+↑下移/上移当前行调整顺序不用剪切粘贴
Ctrl+/行注释—
Shift+Alt+A块注释—
F12跳转到定义读源码的主力
Alt+F12速览定义(Peek,不离开当前文件)快速确认签名
Shift+F12查找所有引用重构前的必备检查
Alt+← / Alt+→返回 / 前进(导航历史)跳走之后一定要能跳回来
Ctrl+Shift+O当前文件符号列表大文件导航
Ctrl+G跳到指定行根据报错日志定位
Ctrl+K Ctrl+0 / Ctrl+K Ctrl+J折叠全部 / 展开全部读长文件
Ctrl+K Ctrl+S打开快捷键编辑器查/改快捷键
Ctrl+,打开设置—
Ctrl+Shift+VMarkdown 预览写文档常用
F5 / Shift+F5启动调试 / 停止—
F9切换断点—
F10 / F11单步跳过 / 单步进入—
Shift+Alt+F格式化文档配合 Prettier
Ctrl+Shift+X扩展面板—
Ctrl+\\拆分编辑器(分屏)对照两个文件
Ctrl+1 / Ctrl+2聚焦第 1/2 个编辑器组分屏后快速切换

官方速查表与自定义

官方提供三平台的可打印默认快捷键速查表(Windows / macOS / Linux),可从帮助菜单的「Keyboard Shortcut Reference」获取。要改键位:Ctrl+K Ctrl+S 打开快捷键编辑器 → 搜索命令 → 双击编辑。也可右键任意界面元素选「Configure Keybinding」。

settings.json 与 keybindings.json

VS Code 的设置分两个作用域(scope):

作用域位置生效范围典型用途
用户设置(User)本机用户目录,如 %APPDATA%\Code\User\settings.json打开任何项目都生效字体、主题、编辑器行为、个人偏好
工作区设置(Workspace)项目根目录 .vscode/settings.json仅本项目生效,覆盖用户设置项目缩进、格式化器、语言相关配置

优先级:工作区 > 用户 > 默认值(语言特定设置 [python] 又高于同层的通用设置)。

settings.json(可直接使用的起点):

{
  // ── 编辑器基础 ──────────────────────────────────
  "editor.fontSize": 15,
  "editor.lineHeight": 1.6,
  "editor.fontFamily": "'JetBrains Mono', 'Cascadia Code', Consolas, monospace",
  "editor.fontLigatures": true,             // 连字:!= >= => 显示为单符号
  "editor.tabSize": 2,
  "editor.insertSpaces": true,
  "editor.detectIndentation": false,        // 关掉自动探测,避免与他人文件互相干扰
  "editor.rulers": [100],                   // 100 列参考线
  "editor.renderWhitespace": "boundary",    // 只显示行首行尾空白,便于发现混用的 tab
  "editor.bracketPairColorization.enabled": true,
  "editor.guides.bracketPairs": "active",
  "editor.minimap.enabled": false,          // 屏幕小时可关,省横向空间
  "editor.stickyScroll.enabled": true,      // 顶部固定显示当前所在函数/类

  // ── 保存与格式化 ────────────────────────────────
  "files.autoSave": "onFocusChange",        // 切窗口时自动保存
  "files.eol": "\n",                        // 统一 LF,避免跨平台 CRLF 冲突
  "files.trimTrailingWhitespace": true,
  "files.insertFinalNewline": true,
  "editor.formatOnSave": true,
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": "explicit",
    "source.organizeImports": "explicit"
  },

  // ── 语言特定:各自用各自的主流格式链 ─────────────
  "[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
  "[typescript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
  "[json]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
  "[markdown]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode",
    "editor.wordWrap": "on"                 // 文档要自动换行
  },
  "[python]": {
    "editor.defaultFormatter": "charliermarsh.ruff",
    "editor.tabSize": 4,
    "editor.codeActionsOnSave": { "source.organizeImports.ruff": "explicit" }
  },
  "[csharp]": { "editor.tabSize": 4 },

  // ── 文件与搜索 ──────────────────────────────────
  "files.exclude": {
    "**/node_modules": true,
    "**/dist": true,
    "**/__pycache__": true,
    "**/.pytest_cache": true
  },
  "search.exclude": {
    "**/node_modules": true,
    "**/package-lock.json": true
  },

  // ── 终端 ────────────────────────────────────────
  "terminal.integrated.defaultProfile.windows": "PowerShell",
  "terminal.integrated.fontSize": 14,
  "terminal.integrated.cursorBlinking": true,

  // ── 其他体验 ────────────────────────────────────
  "explorer.confirmDelete": true,
  "explorer.confirmDragAndDrop": false,
  "git.autofetch": true,
  "git.confirmSync": false,
  "workbench.startupEditor": "none",
  "telemetry.telemetryLevel": "off"
}

keybindings.json(自定义快捷键,用 Ctrl+Shift+P → Preferences: Open Keyboard Shortcuts (JSON) 打开):

// keybindings.json —— 是一个数组,每一项是一条绑定
[
  {
    // 把「格式化文档」改成 Ctrl+Alt+L(避免和别的键冲突)
    "key": "ctrl+alt+l",
    "command": "editor.action.formatDocument",
    "when": "editorTextFocus && !editorReadonly"
  },
  {
    // Ctrl+Shift+D 打开调试面板(默认是 Ctrl+Shift+D 的变体,这里固定下来)
    "key": "ctrl+shift+d",
    "command": "workbench.view.debug"
  },
  {
    // 快速打开用户设置 JSON
    "key": "ctrl+alt+s",
    "command": "workbench.action.openSettingsJson"
  },
  {
    // 在终端与编辑器之间切换焦点
    "key": "ctrl+`",
    "command": "workbench.action.terminal.toggleTerminal"
  },
  {
    // 删除默认绑定:把 Ctrl+K Ctrl+0 的折叠全部取消(示例)
    "key": "ctrl+k ctrl+0",
    "command": "-editor.foldAll"
  }
]

配置的两个常见坑

1. settings.json 严格来说是 JSONC(允许注释与尾逗号),但某些工具读取它时会报错——用 VS Code 内置编辑器改就不会出问题;

2. 抄别人的配置前先看版本:配置项会被重命名或移除(如早期的 editor.autoIndent 语义变更、prettier.* 系列迁移)。抄完如果设置项显示为灰色带删除线,说明该键已废弃。

.vscode/ 目录该不该提交到 Git

答案:分文件看。

文件提交?理由
settings.json✅ 提交项目级规范(缩进、格式化器、排除项),全员一致才有意义
extensions.json✅ 提交推荐插件清单,新人打开项目会收到安装提示
launch.json✅ 通常提交调试配置是项目知识(如何启动、参数、环境变量)
tasks.json✅ 提交构建/测试任务定义,团队共享
*.code-snippets(项目级)✅ 可选项目专用模板,如本项目的组件骨架
snippets/(个人片段)⚠️ 视情况若含个人习惯,放用户目录而非项目
任何含密钥/本地绝对路径的文件❌ 绝不如 settings.json 里写死的 token、launch.json 里的本机路径

对应的 .gitignore 写法(保留项目文件,忽略个人文件):

.vscode/*
!.vscode/settings.json
!.vscode/extensions.json
!.vscode/launch.json
!.vscode/tasks.json
!.vscode/*.code-snippets

一条判据

问自己:「同事 clone 之后没有这个文件,会不会少一块项目知识?」 会 → 提交;不会(纯粹是我的个人偏好)→ 不提交。

多根工作区(multi-root workspace)

一个窗口里放多个项目文件夹,适合「前端 + 后端 + 共享库」这类跨仓库开发。

创建方式:

  1. 菜单 文件 → 将文件夹添加到工作区…;
  2. 或 文件 → 将工作区另存为…,生成 .code-workspace 文件:
// my-platform.code-workspace
{
  "folders": [
    { "name": "前端", "path": "web" },
    { "name": "后端", "path": "api" },
    { "name": "共享类型", "path": "packages/shared" }
  ],
  "settings": {
    // 工作区级设置:只在这个组合下生效
    "editor.formatOnSave": true,
    "search.exclude": { "**/packages/shared/dist": true }
  },
  "extensions": {
    "recommendations": ["Vue.volar", "ms-python.python"]
  },
  "launch": {
    "compounds": [
      {
        "name": "前后端一起调试",
        "configurations": ["启动前端", "启动后端"]
      }
    ]
  }
}

要点:

  • 每个文件夹的 .vscode/settings.json 仍然生效,工作区设置优先级更高;
  • launch.json 的 compounds 可以一次启动多个调试配置(前后端联调必备);
  • .code-workspace 文件本身建议提交(它就是项目结构的一部分)。
远程开发:Remote-SSH / Dev Containers / WSL

官方对 Remote Development 的定位:用容器、远程机器或 WSL 作为完整开发环境,好处是「与部署环境同系统」「使用更强大的硬件」「环境隔离」「新人一键获得一致环境」「使用本机没有的工具或版本」,而且源代码不必放在本机。

方案原理适合场景关键前置
Remote - SSH本机 VS Code 作为客户端,远程机器上跑 VS Code Server,扩展在远程执行开发机在公司/云上;本地机器性能不足;需要 Linux 环境能 SSH 登录,远程需有 glibc 等基础库
Dev Containers用 Docker 容器作为开发环境,.devcontainer/devcontainer.json 描述环境团队环境一致性;一个仓库一个干净环境;同时维护多个技术栈版本本机装 Docker Desktop / Docker Engine
WSL在 Windows 上通过 WSL 2 跑 Linux 子系统,VS Code 连进 WSLWindows 用户需要 Linux 工具链(bash、apt、gcc)启用 WSL 2 并安装发行版
Remote - Tunnels通过安全隧道连接,无需配置 SSH临时接入、难以配置网络的机器登录隧道账号

工作方式(非常重要的一点):扩展安装在远程端。你在「扩展」面板里会看到「本地 - 已安装 / SSH: 主机 - 已安装」两组。这解释了为什么远程开发能获得与远程机器一致的工具链——语言服务器、调试器、终端都在那边跑。

// .devcontainer/devcontainer.json —— 一个可直接用的 Python 开发容器
{
  "name": "Python 3.12 开发环境",
  "image": "mcr.microsoft.com/devcontainers/python:3.12",
  "features": {
    "ghcr.io/devcontainers/features/node:1": { "version": "22" },
    "ghcr.io/devcontainers/features/git:1": {}
  },
  "customizations": {
    "vscode": {
      "extensions": [
        "ms-python.python",
        "ms-python.vscode-pylance",
        "charliermarsh.ruff",
        "EditorConfig.EditorConfig"
      ],
      "settings": {
        "python.defaultInterpreterPath": "/usr/local/bin/python",
        "editor.formatOnSave": true
      }
    }
  },
  "postCreateCommand": "pip install -r requirements.txt",
  "forwardPorts": [8000],
  "remoteUser": "vscode"
}
# 无编辑器时,用 CLI 直接用容器跑命令(devcontainer CLI)
npm i -g @devcontainers/cli
devcontainer up --workspace-folder .
devcontainer exec --workspace-folder . python -m pytest

与容器化的关系

Dev Containers 里说的容器与生产镜像不是一回事:前者是开发环境,后者是交付制品。镜像分层、Dockerfile、Compose、数据卷等内容见 后端-07-Docker与容器化。

Visual Studio / Rider:C# 开发为什么用它们

能力Visual Studio 2022RiderVS Code + C# Dev Kit
解决方案/项目模型原生、最强原生(基于 ReSharper 引擎)支持但较弱
代码分析深度强,分析器体系完善极强(ReSharper 家族)中等
重构丰富最丰富基础够用
调试器Windows 上最强(含并发、GPU、混合模式)强,跨平台基础,够日常
性能剖析内置 Profiler、内存/CPU/异步分析内置 dotTrace/dotMemory 集成基本没有
测试工具测试资源管理器、Live Unit Testing测试资源管理器测试面板
跨平台仅 WindowsWindows / macOS / Linux全平台
资源占用高中高低
价格Community 版免费(个人、开源、学术、小团队)商业授权(有免费试用与非商业免费选项)免费

社区版是否够用? 对个人学习、开源项目、学生和小团队(人数上限以内),Visual Studio Community 版功能足够:完整的编辑器、调试器、诊断工具、Git 集成、单元测试都在。Professional 及更高版本主要多出的是企业协作、架构工具、高级诊断、CodeLens 增强等,学习阶段通常用不上。

怎么选

- 学 C# / .NET,用 Windows:Visual Studio Community(开箱即用,调试最强);

- 跨平台或已习惯 JetBrains:Rider;

- 多语言混合项目(前端 + 一点 C#):VS Code + C# Dev Kit;

- 只写脚本级 C#(如 dotnet run 的小工具):VS Code 完全够。

语言基础与环境搭建见 CSharp-01-环境与基础语法,解决方案与工具链见 CSharp-07-dotnet项目与工具链。

PyCharm / WebStorm:JetBrains 系列

JetBrains 的强项是索引驱动的深度代码智能:

强项具体表现
重构跨文件安全重命名、提取方法/变量/参数、内联、改变签名、移动成员
静态检查内置大量意图(intention)与检查,能在无类型注解时推断问题
数据库工具DataGrip 引擎内嵌(PyCharm Professional),能直接查库、改数据、看执行计划
调试可视化调试器,条件断点、求值表达式、附加进程体验好
版本控制图形化 Git 操作最完善(逐行暂存、冲突解决)
远程/容器远程解释器、Docker、WSL 支持成熟

代价:

  • 内存占用高:一个大型项目常驻 1.5~3 GB,多开项目更明显;
  • 启动与索引慢:首次打开大型仓库要等索引;
  • 社区版功能受限:PyCharm Community 不含数据库工具、远程开发、部分 Web 框架支持;专业版需订阅;
  • 配置复杂:功能多意味着菜单深,新手容易迷路。
产品定位替代方案
PyCharm Community纯 Python 开发VS Code + Pylance + Ruff
PyCharm ProfessionalPython + Web + 数据库 + 远程VS Code(需装更多插件)
WebStorm前端(JS/TS/Vue/React/Node)VS Code + Volar/ESLint
IntelliJ IDEA Community/UltimateJava/Kotlin(Ultimate 含 Web/企业框架)VS Code + 扩展包
Rider.NET / Unity / Unreal C++Visual Studio

结论

不是因为「JetBrains 更强」就必须换。如果你现在的编辑器能让你「不打断思路地写代码」,就继续用。真正的切换理由是具体的痛点:例如「我要跨 30 个文件安全重命名一个类」「我要在 IDE 里直接连生产只读库看数据」。

终端编辑器 vi/vim:服务器的生存技能

为什么必须会一点:

  • 服务器上不一定有 VS Code:很多最小化安装的 Linux 只有 vi;
  • 改配置文件是高频操作:nginx.conf、sshd_config、.env、systemd unit;
  • 通过 SSH 时图形界面不可用;
  • 紧急排障时没有时间装编辑器。

最小生存指令集(记住这些就够应急):

操作按键说明
进入编辑模式i在光标前插入(a 在光标后,o 下方新起一行)
退出编辑模式Esc回到普通模式,所有命令都在普通模式下按
保存:w写入文件
保存并退出:wq 或 ZZ最常用
不保存退出:q!丢弃修改(改错了就用它)
保存(需要权限):w !sudo tee %忘用 sudo 打开时的救急
撤销u普通模式下按
重做Ctrl+r撤销的反操作
删除整行dd—
复制整行yy—
粘贴p—
查找/关键字 然后 n 下一个:noh 取消高亮
跳到文件开头/末尾gg / G—
跳到指定行:42配合报错行号
显示行号:set nu—
替换(当前行):s/旧/新/g—
替换(全文,需确认):%s/旧/新/gc危险操作,务必先备份

vi 里的两个经典事故

1. Ctrl+S 卡死:终端里 Ctrl+S 是「暂停输出」,会让人以为编辑器卡住。按 Ctrl+Q 恢复。

2. 改配置不备份:在 vi 里改了 sshd_config 保存后重启服务失败,SSH 断了就再也连不上。改任何远程配置前先 cp sshd_config sshd_config.bak。

诚实评估学习曲线与收益:

阶段投入收益
会 10 个指令(上表)30 分钟能在服务器上改配置——这是必须的
会基本移动与文本对象(dw、ci"、5j)3~5 小时编辑速度接近鼠标操作
配置插件与 LSP(Neovim)20 小时以上特定场景下极快,但收益高度依赖你的工作类型与长期投入

建议:所有人花 30 分钟学「最小生存指令集」;只有当你是「每天在终端里泡 6 小时以上」的开发者时,才考虑深入 Neovim 这类路线。为炫技而折腾配置是负收益。

.editorconfig:跨编辑器统一基础风格

.editorconfig 解决的问题:团队里有人用 VS Code、有人用 Visual Studio、有人用 Vim,各自默认缩进不同,导致 diff 里全是空白变更。

它的机制(官方说明):编辑器插件从当前文件所在目录向上逐级查找名为 .editorconfig 的文件,直到找到 root = true 或到达根目录;越靠近文件的配置优先级越高,同名文件内后出现的规则覆盖先出现的规则。

VS Code 需要安装 EditorConfig.EditorConfig 扩展;Visual Studio、JetBrains 系列、Vim、Sublime、Neovim、Emacs 等都已内置或官方支持。

.editorconfig(多语言项目模板):

# EditorConfig 官方站点:https://editorconfig.org
# 根文件标记:找到它就不再向上查找
root = true

# ── 所有文件的默认规则 ────────────────────────────
[*]
charset = utf-8
end_of_line = lf
insert_final_newline = true
trim_trailing_whitespace = true
indent_style = space
indent_size = 2

# ── 按语言覆盖 ────────────────────────────────────
[*.py]
indent_size = 4
max_line_length = 100

[*.{js,jsx,ts,tsx,vue,json,yml,yaml,md}]
indent_size = 2

[*.cs]
indent_size = 4

[*.go]
indent_style = tab

[Makefile]
indent_style = tab        # Makefile 必须用 tab,这是语法要求

[*.{bat,cmd}]
end_of_line = crlf        # Windows 批处理需要 CRLF

[*.md]
trim_trailing_whitespace = false   # Markdown 的行尾两空格表示换行,不能删

支持的主要属性:

属性取值说明
indent_styletab / space硬制表符还是空格
indent_size整数或 tab每级缩进的列数
tab_width整数制表符显示宽度(默认等于 indent_size)
end_of_linelf / crlf / cr换行符(跨平台协作的关键)
charsetutf-8 / utf-8-bom / latin1 / utf-16be / utf-16le字符集
trim_trailing_whitespacetrue / false删除行尾空白
insert_final_newlinetrue / false文件末尾补换行
roottrue只出现在文件顶部,停止向上查找
unset(值)—取消某个属性,回到编辑器默认

为什么 .editorconfig 比「口头约定」有效

口头约定依赖每个人记得住并愿意执行;.editorconfig 由编辑器自动执行。这是「把约定变成工具」的典型例子,与用 Prettier 消灭格式争论是同一个思路(见 工具-05-GitHub与GitLab协作 的 Code Review 方法论)。

字体与主题

项目建议理由
字体类型等宽字体(monospace)代码对齐依赖字符等宽
常见选择JetBrains Mono、Cascadia Code、Fira Code、Source Code Pro、Sarasa Gothic(中英等宽混排)字形辨识度高(0O、1lI、rn/m 区分明显)
连字(ligatures)视个人偏好开启!=、>=、=>、=== 显示为单个符号,减少视觉噪声;但别人看你的屏幕/截图会不习惯
中文字体与等宽西文搭配(如 Sarasa Mono SC)避免中英混排时行高跳变
字号14~16 px小于 13 px 长时间阅读伤眼;大于 17 px 一屏信息量太少
行高1.5~1.7太低难扫行,太高滚动频繁
主题低对比度、少高饱和色纯黑背景 + 纯白字的对比度过高,长时间阅读易疲劳
护眼偏暖色的深色主题,或在明亮环境用浅色主题关键是环境光与屏幕亮度匹配,主题颜色其次
// 一套平衡的显示配置
{
  "editor.fontFamily": "'JetBrains Mono', 'Cascadia Code', 'Sarasa Mono SC', Consolas, monospace",
  "editor.fontSize": 15,
  "editor.lineHeight": 1.6,
  "editor.fontLigatures": true,
  "editor.fontWeight": "400",
  "workbench.colorTheme": "Default Dark Modern",
  "workbench.iconTheme": "material-icon-theme",
  "editor.smoothScrolling": true,
  "editor.cursorSmoothCaretAnimation": "on",
  "editor.renderLineHighlight": "all"
}

别在主题上花超过 10 分钟

主题的唯一硬指标是「长时间看不累」。挑一个默认深色主题,把时间留给代码。至于「哪个主题最好看」,和编程能力无关。

代码片段(Snippets)

片段是「用短前缀展开成一段模板」的机制,适合消灭重复劳动:

  • 内置片段:JavaScript、TypeScript、Markdown、PHP 等语言自带;
  • 市场片段:在扩展面板搜 @category:"snippets";
  • 自定义片段:文件 → 首选项 → 配置用户代码片段,选择语言或「新建全局代码片段文件」。

片段语法(遵循 TextMate 语法,但不支持 shell 插值与 \u):

// 用户片段文件:python.json
{
  "pytest 测试函数": {
    "prefix": ["ptest", "pytest-fn"],
    "body": [
      "def test_${1:场景描述}():",
      "\t# Arrange",
      "\t${2:setup}",
      "",
      "\t# Act",
      "\t${3:result} = ${4:func}()",
      "",
      "\t# Assert",
      "\tassert ${3:result} == ${5:期望值}"
    ],
    "description": "生成 AAA 结构的 pytest 测试函数"
  }
}
// 全局片段文件(*.code-snippets),可用 scope 限定语言
{
  "带日期的 Markdown 标题": {
    "scope": "markdown",
    "prefix": "h2date",
    "body": ["## ${1:标题}", "", "> 记录时间:$CURRENT_YEAR-$CURRENT_MONTH-$CURRENT_DATE"],
    "description": "插入带日期的二级标题"
  }
}

要点:

  • ${1:默认值}` 是占位符,按 `Tab` 依次跳转;`$0 是最后的光标位置;
  • 同一片段可以有多个 prefix(用数组);
  • 前缀匹配是子串匹配,所以 fc 能匹配到 for-const;
  • 需要 "editor.tabCompletion": "on" 才能在键入前缀后直接按 Tab 展开;
  • 项目级片段放在 .vscode/*.code-snippets,可以随仓库共享(团队统一模板的好办法)。

片段的两个反模式

1. 片段里塞一整屏代码:展开后要改十几个地方,还不如复制粘贴;

2. 过度依赖片段:如果你连 for 循环都要靠片段,说明你对该语言的熟练度还没到位。片段应该用于长而固定的模板(测试骨架、日志语句、异常包装)。

终端集成与分屏布局建议

VS Code 的集成终端默认用 Ctrl+ 开关,可同时开多个终端(点终端面板右上角的 +)。

用途建议布局
写业务代码左:代码;右:同文件的测试;底部:终端(跑测试)
调试问题左:代码 + 断点;右:调试控制台 / 监视;底部:日志输出
前后端联调两个编辑器组;底部两个终端(前端 dev server、后端 API)
读源码左:文件树 + 源码;右:多个 Peek 速览(不占布局)
写文档左:Markdown 源码;右:Ctrl+K V 预览(并排预览)

实用技巧:

  • Ctrl+K V:在侧边打开 Markdown 预览(Ctrl+Shift+V 是全屏预览);
  • Ctrl+\\:拆分编辑器;Ctrl+1 / Ctrl+2 切换编辑器组;
  • 终端分组:终端面板里可继续拆分,前端/后端各占一格;
  • 多根工作区 + compounds 调试:一次启动前后端(见上文);
  • Ctrl+Shift+P → View: Toggle Panel Position:面板放左/右/底部,配合宽屏可放右侧;
  • 关闭不需要的面板:状态栏、面包屑、小地图都占空间,屏幕小时先关小地图。

怎么用

完整配置文件汇总

.vscode/settings.json(项目级,提交到 Git)

{
  // 项目缩进与换行(与 .editorconfig 保持一致)
  "editor.tabSize": 2,
  "editor.insertSpaces": true,
  "files.eol": "\n",
  "files.trimTrailingWhitespace": true,
  "files.insertFinalNewline": true,

  // 项目格式化:统一走 Prettier,避免各人格式不同
  "editor.defaultFormatter": "esbenp.prettier-vscode",
  "editor.formatOnSave": true,
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": "explicit"
  },

  // Python 项目专用
  "[python]": {
    "editor.defaultFormatter": "charliermarsh.ruff",
    "editor.tabSize": 4,
    "editor.codeActionsOnSave": { "source.organizeImports.ruff": "explicit" }
  },

  // 排除噪音目录,让搜索与文件树清爽
  "files.exclude": {
    "**/node_modules": true,
    "**/.venv": true,
    "**/__pycache__": true,
    "**/.pytest_cache": true,
    "**/dist": true
  },
  "search.exclude": {
    "**/node_modules": true,
    "**/dist": true,
    "**/coverage": true,
    "**/*.lock": true
  },

  // 集成终端
  "terminal.integrated.cwd": "${workspaceFolder}",
  "terminal.integrated.defaultProfile.windows": "PowerShell",

  // 测试集成(VS Code 内置测试面板)
  "python.testing.pytestEnabled": true,
  "python.testing.pytestArgs": ["tests"]
}

.vscode/extensions.json(项目推荐插件,提交到 Git)

{
  "recommendations": [
    "EditorConfig.EditorConfig",
    "esbenp.prettier-vscode",
    "dbaeumer.vscode-eslint",
    "usernamehw.errorlens",
    "eamodio.gitlens",
    "ms-python.python",
    "ms-python.vscode-pylance",
    "charliermarsh.ruff",
    "yzhang.markdown-all-in-one"
  ],
  "unwantedRecommendations": [
    "hookyqr.beautify"        // 与 Prettier 冲突的老格式化插件
  ]
}

.vscode/launch.json(调试配置,通常提交)

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Python: 当前文件",
      "type": "debugpy",
      "request": "launch",
      "program": "${file}",
      "console": "integratedTerminal",
      "justMyCode": true
    },
    {
      "name": "Python: pytest",
      "type": "debugpy",
      "request": "launch",
      "module": "pytest",
      "args": ["-v", "tests/"],
      "console": "integratedTerminal"
    },
    {
      "name": "Node: 启动开发服务器",
      "type": "node",
      "request": "launch",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "skipFiles": ["<node_internals>/**"],
      "console": "integratedTerminal"
    },
    {
      "name": "附加到 Chrome",
      "type": "chrome",
      "request": "launch",
      "url": "http://localhost:5173",
      "webRoot": "${workspaceFolder}/src"
    }
  ],
  "compounds": [
    {
      "name": "全栈调试(前端 + 后端)",
      "configurations": ["Node: 启动开发服务器", "Python: 当前文件"],
      "stopAll": true
    }
  ]
}

.vscode/tasks.json(常用任务,提交)

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "安装依赖",
      "type": "shell",
      "command": "npm ci",
      "problemMatcher": []
    },
    {
      "label": "跑全部检查(lint + 类型 + 测试)",
      "type": "shell",
      "command": "npm run lint && npm run typecheck && npm run test",
      "group": { "kind": "test", "isDefault": true },
      "problemMatcher": ["$eslint-stylish"]
    },
    {
      "label": "格式化并修复",
      "type": "shell",
      "command": "npx prettier --write . && npx eslint . --fix",
      "problemMatcher": []
    },
    {
      "label": "启动后端(Windows)",
      "type": "shell",
      "command": ".venv\\Scripts\\python.exe -m uvicorn app.main:app --reload",
      "options": { "cwd": "${workspaceFolder}/api" },
      "problemMatcher": []
    }
  ]
}

.editorconfig(仓库根目录,提交)

root = true

[*]
charset = utf-8
end_of_line = lf
insert_final_newline = true
trim_trailing_whitespace = true
indent_style = space
indent_size = 2

[*.py]
indent_size = 4
max_line_length = 100

[*.cs]
indent_size = 4

[*.go]
indent_style = tab

[Makefile]
indent_style = tab

[*.{bat,cmd}]
end_of_line = crlf

[*.md]
trim_trailing_whitespace = false

可执行命令清单

# ── 打开项目 ────────────────────────────────────────
code .                        # 在终端里打开当前目录
code -n .                     # 新窗口打开
code -r .                     # 复用现有窗口打开(推荐)
code -g src/app.py:42         # 直接打开并跳到第 42 行
code --diff a.txt b.txt       # 对比两个文件
code --list-extensions        # 列出已安装插件
code --install-extension ms-python.python
code --uninstall-extension <id>
code --disable-extensions     # 排查「插件冲突」时以纯净模式启动(重要排错手段)

# ── 用配置文件批量装插件(换机迁移)─────────────────
# 1) 导出
code --list-extensions > vscode-extensions.txt
# 2) 新机器导入
cat vscode-extensions.txt | xargs -L 1 code --install-extension
# Windows PowerShell 版本:
# Get-Content vscode-extensions.txt | ForEach-Object { code --install-extension $_ }

# ── 让 VS Code 成为 Git 的默认编辑器 ─────────────────
git config --global core.editor "code --wait"
git config --global merge.tool vscode
git config --global mergetool.keepBackup false

# ── 定位配置文件位置 ────────────────────────────────
# Windows: %APPDATA%\Code\User\settings.json
# macOS:   ~/Library/Application Support/Code/User/settings.json
# Linux:   ~/.config/Code/User/settings.json
# 最可靠的方式:命令面板执行
#   Preferences: Open User Settings (JSON)
#   Preferences: Open Keyboard Shortcuts (JSON)

# ── vim 最小生存指令(在服务器上)───────────────────
vim /etc/nginx/nginx.conf
#   i            进入插入模式
#   Esc          回普通模式
#   :w           保存
#   :wq          保存退出
#   :q!          不保存退出
#   :set nu      显示行号
#   /location    搜索 location
#   dd           删除整行
#   u            撤销
# 改远程配置前务必先备份:
cp /etc/nginx/nginx.conf /etc/nginx/nginx.conf.bak

常见坑

编辑器相关的常见坑

1. 在学习期折腾配置:浪费几十小时,代码没写几行。先写代码,遇到痛点再改配置。

2. 抄别人的 settings.json 不验证:废弃的配置项会变灰或被忽略,某些还会引发冲突(例如同时启用 Prettier 与另一个格式化插件,导致保存时格式来回变)。

3. 同时装多个同类插件:两个格式化器、两个 linter(ESLint + TSLint 已弃用)、两个 Python 语言服务器,会互相打架。同类只留一个。

4. 把个人偏好提交到 .vscode/settings.json:如绝对路径、字体大小、某个人的快捷键。项目设置只放团队规范。

5. 把密钥写进 launch.json:调试配置常被提交,"env": { "API_KEY": "sk-..." } 是常见泄漏点。用 "envFile" 指向被忽略的 .env。

6. CRLF/LF 混用:Windows 默认 CRLF,Linux 默认 LF,Git 里就会出现「整文件都变了」的假 diff。用 .editorconfig 的 end_of_line = lf + git config core.autocrlf 统一。

7. .md 关掉 trim_trailing_whitespace 忘了:Markdown 用行尾两个空格表示硬换行,全局删尾随空格会破坏排版。

8. 在服务器上 vi 改配置不备份:改坏了 SSH 连不上,只能走控制台救援。

9. 终端里按 Ctrl+S:会「冻结」终端输出,按 Ctrl+Q 恢复。

10. Remote 开发时插件装错端:语言服务器要装在远程,主题与快捷键类装在本地。

出问题时的排错顺序

1. code --disable-extensions 启动:如果问题消失 → 插件冲突,逐个启用来定位;

2. 命令面板执行 Developer: Reload Window:多数偶发问题靠重载窗口解决;

3. 查看 帮助 → 切换开发人员工具 的控制台输出;

4. 命令面板执行 Developer: Show Running Extensions:看哪个扩展启动了、耗时多少(这也是排查「启动慢」的主要手段);

5. 最后手段:备份 settings.json 后重置用户数据目录。

练习题

  1. 工具选择:分别说明下面四个任务你会用什么工具,并给出一条理由。

(a) 学习 C# 并调试一个控制台程序;

(b) 在只装了 vi 的云服务器上把 Nginx 的 root 路径从 /var/www/html 改成 /srv/site;

(c) 在一个 Vue 3 + TypeScript 项目里重构一个被 200 个文件引用的组件名;

(d) 快速看一眼某个 JSON 文件里的字段名。

  1. 配置实践:为你的项目写一份 .vscode/settings.json 与 .editorconfig,要求:
  • Python 用 4 空格、单行最长 100 字符;
  • JavaScript/TypeScript 用 2 空格;
  • 所有文本文件统一 LF、保存时删除行尾空白、末尾补换行;
  • Markdown 文件不删除行尾空白;
  • Makefile 用 tab 缩进。

写完后说明:为什么这两份文件的职责有重叠但不能互相替代?

  1. 快捷键设计:假设你每天要做 20 次「格式化当前文件」和 10 次「跑当前测试」。当前这两个操作都需要三级菜单。请用 keybindings.json 设计两条自定义快捷键,说明 when 条件为什么重要(例如为什么不该在终端聚焦时也响应)。
  1. 远程开发判断:一个团队要在 Windows 上开发一个只能跑在 Linux 的 Python 服务(依赖 libpq-dev、gcc),且新人有「环境装不起来」的老问题。请给出三种方案(本机 WSL / Remote-SSH / Dev Containers),比较各自的搭建成本与一致性收益,并给出推荐。
  1. vim 应急:你在 SSH 会话里 vi 打开了一个配置文件,改了 3 行,现在想不保存直接退出;另一次你改完想保存但提示 E45: 'readonly' option is set。分别写出按键序列,并说明第二种情况在「已用普通用户打开 root 文件」时的常见解法。

FAQ

VS Code 能完全替代 Visual Studio / PyCharm 吗?

取决于项目复杂度与你的工作类型。可以替代:中小型项目、跨语言工作区、脚本与 Web 开发、需要轻量与远程开发的场景。难以替代:几百个项目的 .NET 解决方案(需要强项目模型与解决方案级重构)、需要性能剖析与内存分析、需要 Live Unit Testing、需要 JetBrains 级别的跨语言重构与数据库内嵌工具。务实建议:先用手上的工具把事做完,真遇到「这个 IDE 做不了、另一个能」的具体场景再换,不要因为别人推荐就换。

学 Vim 值得吗?我不想在配置上浪费时间。

分两层看。「会一点 vi」是必选项:10~15 个指令(i/Esc/:wq/:q!/dd///u)总共不到一小时,但它是你能否在服务器上独立改配置的分界线。「把 Neovim 配置成主力 IDE」是选修项:投入 20 小时以上,收益高度依赖工作类型,对大多数学习者来说是负收益。不要为了显得专业而折腾编辑器。

团队里有人用 VS Code,有人用 Visual Studio,格式总打架,怎么办?

三层防线,从强到弱:(1) .editorconfig 统一缩进、换行符、字符集——这是所有编辑器都认的最小公约数;(2) 格式化工具(Prettier / Ruff / dotnet format)由 CI 强制 --check,本地随意、入库必须统一;(3) 提交前钩子(pre-commit / husky + lint-staged)自动格式化待提交文件。三层都上之后,「格式打架」这个议题就彻底消失了。相关实践见 工具-05-GitHub与GitLab协作 与 前端-09-前端工程化与调试。

换电脑后怎么快速恢复开发环境?

把「环境」当成代码来管理:

1. 编辑器配置入 Git:建一个 dotfiles 仓库,放 settings.json、keybindings.json、.editorconfig、.gitconfig;

2. 插件清单入 Git:code --list-extensions > vscode-extensions.txt,新机器一条命令装回来;

3. 项目环境容器化:.devcontainer/devcontainer.json + Dockerfile,克隆即用;

4. 依赖锁定:package-lock.json / poetry.lock / requirements.txt(见 工具-03-包管理器);

5. 顺带开启 VS Code 的 Settings Sync(用账号同步设置、快捷键、插件)作为兜底——但重要配置仍要有 Git 版本,因为同步是黑盒且不便于评审。

相关笔记

  • 工具-07-调试技巧:断点、条件断点、日志与二分定位的完整方法。
  • CSharp-01-环境与基础语法:C# 的环境搭建与语言基础(配合 Visual Studio / Rider / VS Code)。
  • Python-01-环境与基础语法:Python 解释器、虚拟环境与编辑器配置的衔接。
  • 前端-09-前端工程化与调试:Prettier / ESLint 与编辑器集成、浏览器调试。
  • 后端-07-Docker与容器化:Dev Containers 背后的镜像、容器与数据卷原理。
  • 工具-05-GitHub与GitLab协作:GitLens、分支可视化与协作流程的配合。

参考来源

版本提示

VS Code 的配置项与界面会随版本变化(例如设置面板改为模态浮层、部分设置键重命名),本文配置以撰写时的版本为准;请以官方文档与编辑器内的设置提示为准。