简介这是一份面向编程初学者与希望提升编码效率的开发者的 VSCode 基础使用教程以 PDF 文档形式系统梳理了这款免费开源编辑器的常用操作与实用技巧。内容从命令面板、界面布局、命令行调用等快速入门知识讲起逐步深入到光标移动与回溯、多文件切换、文本选择、代码删除与移动、单行与块注释、整体及选区格式化、缩进调整、大小写转换、行合并与排序、多光标编辑等高频操作并配有 Mac 与 Windows 双平台快捷键对照方便不同系统用户查阅。资源包内含 1 个 PDF 文件大小约 711KB轻量易读适合随时翻阅。目前已有 1244 人学习下载读者可借此快速熟悉 VSCode 的核心交互方式掌握提升日常编码效率的快捷键与编辑技巧为后续学习查找替换、调试、集成 Git 及插件扩展等进阶功能打下基础。1. 为什么有人用 VS Code 三年还在用鼠标右键格式化如果你刚装好 VS Code第一反应多半是「这不就是个高级记事本」。但真正拉开效率差距的从来不是界面好不好看而是你有没有把「打开文件、改代码、跑命令、提交版本」这四件事压进键盘里。我见过工作三年的开发者改完代码还在用鼠标点右键找格式化终端窗口单独开一个Git 提交靠插件按钮——每一步都慢两秒一天下来就是半小时。这篇笔记面向两类人刚接触 VS Code 想系统搭一套工作流的新手以及用了很久但总觉得「哪里不对劲」的老用户。我会从安装后的第一组配置讲起一路落到多光标、任务系统、调试配置和远程开发把每个环节的参数、快捷键和踩坑点都摊开。VS Code 基础使用教程的核心不是背快捷键而是理解它的三层结构编辑器层、工作区层、任务与调试层。搞清这三层你才知道什么该装插件、什么该写配置文件、什么该交给命令行。2. 装完先别急着写代码把编辑器层配置成顺手的形状2.1 设置同步与 settings.json 的优先级VS Code 的设置分三层默认设置、用户设置全局、工作区设置项目级。新手最容易犯的错是把所有东西都塞进用户设置结果换个项目就冲突。我的习惯是主题、字体、快捷键这类跟人走的放用户设置格式化规则、语言特定配置放工作区设置跟着仓库走。打开命令面板CtrlShiftP或CmdShiftP输入Preferences: Open User Settings (JSON)你会看到一个settings.json。这个文件才是真正干活的地方图形界面只是它的可视化外壳。下面是我用了很久的一组基础配置每一项都解释清楚{ // 编辑器基础字体和行高直接影响长时间编码的疲劳度 editor.fontSize: 14, editor.lineHeight: 1.6, editor.fontFamily: JetBrains Mono, Cascadia Code, Consolas, monospace, editor.fontLigatures: true, // 保存时自动格式化但只在有格式化器时才触发避免报错 editor.formatOnSave: true, editor.formatOnSaveMode: file, // 自动保存用 afterDelay比 onFocusChange 更稳不会丢改动 files.autoSave: afterDelay, files.autoSaveDelay: 1000, // 缩进统一团队协作时省掉无数争论 editor.tabSize: 2, editor.insertSpaces: true, editor.detectIndentation: false, // 显示空白字符排查缩进混用时救命 editor.renderWhitespace: boundary, // 终端和资源管理器的一些顺手设置 terminal.integrated.fontSize: 13, explorer.confirmDelete: true, explorer.compactFolders: false }逻辑说明formatOnSave依赖你装了对应语言的格式化器比如 Prettier、Black、gofmt没装的话它不会报错但也不生效这是很多人以为「配置没起作用」的原因。detectIndentation设为 false 是刻意的——自动检测在混合缩进的项目里会来回跳反而添乱。renderWhitespace用boundary而不是all只在词边界显示空白点不会满屏都是点。参数说明autoSaveDelay单位是毫秒1000 表示停止输入 1 秒后保存。如果你用 Git自动保存会让 diff 变得频繁但配合git add -p反而更好用。fontLigatures需要字体支持连字JetBrains Mono 和 Fira Code 都行不支持的字体开了也没效果。2.2 快捷键重映射把高频操作压进左手区VS Code 默认快捷键大量依赖CtrlShift组合右手要跨半个键盘。我的做法是把最常用的十几个操作重映射到左手能覆盖的区域。打开Preferences: Open Keyboard Shortcuts (JSON)写入[ // 命令面板改成 CtrlSpace比 CtrlShiftP 少按一个键 { key: ctrlspace, command: workbench.action.showCommands }, // 快速打开文件 { key: ctrlp, command: workbench.action.quickOpen }, // 侧边栏切换 { key: ctrlb, command: workbench.action.toggleSidebarVisibility }, // 终端切换用反引号比 Ctrl 更顺手 { key: ctrl, command: workbench.action.terminal.toggleTerminal }, // 多光标选中下一个相同词 { key: ctrld, command: editor.action.addSelectionToNextFindMatch }, // 行操作 { key: altup, command: editor.action.moveLinesUpAction }, { key: altdown, command: editor.action.moveLinesDownAction }, { key: shiftaltup, command: editor.action.copyLinesUpAction }, { key: shiftaltdown, command: editor.action.copyLinesDownAction }, // 删除行 { key: ctrlshiftk, command: editor.action.deleteLines } ]逻辑说明CtrlD的多光标是 VS Code 最被低估的功能。改一个变量名按CtrlD逐个选中再按CtrlShiftL全选所有匹配一次性改完。比查找替换安全因为你能看到每一步选中的是什么。AltUp/Down移动行、ShiftAltUp/Down复制行这两个操作在调整代码顺序时比剪切粘贴快得多。参数说明快捷键 JSON 是数组每条有key和command。command的 ID 可以在快捷键设置界面右键「Copy Command ID」拿到。如果冲突VS Code 会在底部提示按提示改掉旧的即可。注意CtrlSpace在部分系统里被输入法占用如果冲突就换成CtrlShiftSpace。2.3 工作区与多根目录一个窗口管多个仓库很多人不知道 VS Code 支持「工作区」Workspace概念。你可以把多个不相关的文件夹加进同一个窗口各自独立配置。做法是File Add Folder to Workspace然后File Save Workspace As存一个.code-workspace文件。这个文件长这样{ folders: [ { path: ./frontend }, { path: ./backend }, { path: ./shared-lib } ], settings: { editor.tabSize: 2, files.exclude: { **/node_modules: true, **/.git: true, **/dist: true } }, extensions: { recommendations: [ esbenp.prettier-vscode, dbaeumer.vscode-eslint ] } }逻辑说明folders里每个路径是一个根目录搜索、替换、Git 操作都会跨这些目录。settings是这个工作区独有的配置不会污染全局。extensions.recommendations会在别人打开这个工作区时提示安装推荐插件团队协作时非常有用。参数说明files.exclude只是隐藏文件不影响搜索。如果要让搜索也跳过得配search.exclude。**/node_modules这种 glob 写法**匹配任意层级。工作区文件建议提交到仓库但路径用相对路径否则换台机器就失效。3. 让代码自己跑起来任务、终端与调试配置3.1 tasks.json把重复命令变成一键操作每次改完代码都要切到终端敲npm run build或者python -m pytest这种重复劳动应该交给任务系统。按CtrlShiftP输入Tasks: Configure Task选「Create tasks.json file from template」会生成.vscode/tasks.json。下面是一个覆盖前端构建和 Python 测试的配置{ version: 2.0.0, tasks: [ { label: build:frontend, type: npm, script: build, path: frontend/, group: { kind: build, isDefault: true }, problemMatcher: [$tsc], presentation: { reveal: silent, panel: shared } }, { label: test:python, type: shell, command: python, args: [-m, pytest, -v, ${workspaceFolder}/tests], group: test, problemMatcher: [], presentation: { reveal: always, panel: dedicated } }, { label: lint:all, dependsOn: [build:frontend, test:python], dependsOrder: parallel, problemMatcher: [] } ] }逻辑说明label是任务名CtrlShiftB会直接跑group.kind为build且isDefault为 true 的任务。problemMatcher决定终端输出里的错误能不能被 VS Code 解析成「问题」面板里的条目$tsc是内置的 TypeScript 编译器匹配器。dependsOn可以串起多个任务dependsOrder设为parallel表示并行跑。参数说明type: npm是 VS Code 内置的 npm 任务类型会自动找package.json里的 script。path指定子目录。presentation.reveal控制终端面板是否自动弹出silent表示只在出错时显示。${workspaceFolder}是变量指向当前工作区根目录类似的还有${file}当前文件、${fileBasenameNoExtension}不带扩展名的文件名。3.2 launch.json调试配置的四个必调参数调试是 VS Code 真正甩开普通编辑器的功能。点左侧「运行和调试」图标创建launch.json。不同语言配置差异大但核心参数就四个type、request、program、cwd。以 Node.js 调试为例{ version: 0.2.0, configurations: [ { name: Debug Current File, type: node, request: launch, program: ${file}, cwd: ${workspaceFolder}, console: integratedTerminal, env: { NODE_ENV: development }, skipFiles: [node_internals/**], sourceMaps: true, outFiles: [${workspaceFolder}/dist/**/*.js] }, { name: Attach to Process, type: node, request: attach, port: 9229, restart: true } ] }逻辑说明request: launch是启动一个新进程调试request: attach是附加到已运行的进程。program指定入口文件${file}表示当前打开的文件这样你可以对任意文件按 F5 直接调试。console: integratedTerminal让程序在集成终端里跑能接受输入比默认的调试控制台好用。参数说明skipFiles让调试器跳过 Node 内部代码单步时不会掉进node_modules。sourceMaps配合outFiles用于 TypeScript 等编译型语言断点打在.ts源文件上实际执行的是编译后的.js。port: 9229是 Node 默认的调试端口启动时加--inspect9229才能附加。restart: true在文件改动后自动重启调试会话省去手动重连。3.3 集成终端的三个实用技巧VS Code 的集成终端不是简单的嵌入它支持多标签、分屏、任务关联。几个我常用的操作第一终端分屏。按CtrlShift5把当前终端拆成左右两半左边跑服务右边跑测试不用来回切标签。第二终端配置文件。在settings.json里加{ terminal.integrated.profiles.windows: { PowerShell: { source: PowerShell, icon: terminal-powershell, args: [-NoLogo] } }, terminal.integrated.defaultProfile.windows: PowerShell, terminal.integrated.scrollback: 10000 }scrollback默认只有 1000 行跑个构建日志就冲没了调到 10000 能保留更多历史。-NoLogo去掉 PowerShell 启动横幅省一行空间。第三终端里的命令可以用code命令反向操作编辑器。比如code -r src/index.js会在当前窗口打开这个文件code -n开新窗口。这个命令需要在安装时勾选「添加到 PATH」如果没勾按CtrlShiftP运行Shell Command: Install code command in PATH补上。4. 避坑与排查那些让你怀疑人生的瞬间4.1 格式化不生效先看这三个地方现象配了formatOnSave保存时毫无反应状态栏也没有任何提示。原因通常有三个一是没装对应语言的格式化扩展VS Code 自带的格式化能力很有限二是装了多个格式化器VS Code 不知道用哪个默认不执行三是文件类型没被识别比如.vue文件没装 Vetur 或 Volar。解决按CtrlShiftP运行Format Document With...如果弹出选择列表说明有多个格式化器选一个后点「Configure Default Formatter」设为默认。如果列表是空的说明没装格式化器。另外检查右下角语言模式是否正确点一下可以手动切换。4.2 搜索搜不到 node_modules 里的东西现象明明知道某个依赖里有这个函数全局搜索就是找不到。原因VS Code 默认把node_modules加进了search.exclude这是为了性能。但有时候你就是需要搜依赖源码。解决在搜索面板点右上角的「...」展开高级选项取消勾选「Use Exclude Settings and Ignore Files」。或者临时在settings.json里把search.exclude里的**/node_modules改成 false。更精细的做法是用search.exclude的when条件但那个配置比较复杂日常用高级选项里的开关就够了。4.3 调试断点变成灰色空心圆现象断点打上去是灰色空心程序跑过去完全不停。原因断点位置和实际执行的代码对不上。常见于 TypeScript 项目没配sourceMaps或者outFiles路径写错调试器找不到源文件对应的编译产物。另一个原因是skipFiles把当前文件也跳过了比如写了**/dist/**但源文件恰好在 dist 目录下。解决先看调试控制台有没有「Breakpoint ignored because generated code not found」之类的提示。有的话检查sourceMaps和outFiles。没有提示的话把skipFiles临时清空试试。还有一个隐蔽情况Node 的--inspect和--inspect-brk区别后者会在第一行暂停前者不会如果你用 attach 模式且程序已经跑过了启动阶段断点自然不生效。4.4 扩展装多了之后启动变慢现象VS Code 启动要十几秒打开大文件卡顿。原因每个扩展都会在启动时激活有些扩展还会监听文件变化、跑后台进程。装了三四十个扩展之后启动时间线性增长。解决按CtrlShiftP运行Developer: Show Running Extensions会列出所有已激活的扩展和它们的启动耗时。把耗时超过 200ms 且不常用的禁用掉。另一个命令是Developer: Startup Performance能看到更细的启动阶段耗时。我的习惯是只保留语言支持、格式化、Git 增强这三类扩展其他按需临时启用。4.5 终端里的中文显示成方块现象集成终端输出中文变成问号或方块。原因终端字体不支持中文或者编码不是 UTF-8。解决在settings.json里把terminal.integrated.fontFamily设成支持中文的等宽字体比如Cascadia Code, Microsoft YaHei Mono, monospace。编码问题在 Windows 上比较常见PowerShell 里运行chcp 65001切到 UTF-8或者把terminal.integrated.defaultProfile.windows的 args 里加上-Command chcp 65001。注意chcp只影响当前会话要持久化得改系统区域设置。5. 从单文件到远程仓库把 VS Code 用成完整工作台5.1 远程开发本地编辑远端运行远程开发是 VS Code 近幾年最有价值的功能之一。它的原理是在远端跑一个 VS Code Server本地只负责界面渲染文件读写、终端、调试全在远端执行。这意味着你可以在性能一般的笔记本上编辑远端高性能机器的代码网络断了也不影响远端进程。配置步骤安装 Remote - SSH 扩展按F1输入Remote-SSH: Connect to Host填userhost连上后 VS Code 会在远端自动装 Server。之后打开远端文件夹所有操作都和本地一样。关键配置在~/.ssh/config里Host dev-box HostName 192.168.1.100 User developer Port 22 ServerAliveInterval 60 ServerAliveCountMax 3ServerAliveInterval 60每 60 秒发一次心跳防止长时间不操作被断开。ServerAliveCountMax 3表示连续 3 次心跳无响应才断开。这两个参数在跨网络环境里很实用。远程开发的坑主要在扩展上有些扩展必须装在远端比如语言服务器有些必须装在本地比如主题VS Code 会自动分类但偶尔会分错。遇到扩展不生效看扩展面板里它显示的是「Install in SSH: xxx」还是「Install Locally」点一下就能切换。5.2 用多光标和正则做批量重构多光标配合正则查找替换能完成很多脚本才能做的事。举个例子把一组const a require(moduleA)改成import a from moduleA。按CtrlH打开替换点.*图标开启正则查找框写const (\w) require\((.?)\)替换框写import $1 from $2(\w)捕获变量名(.?)非贪婪捕获模块路径$1和$2在替换时引用。点「Replace All」一次性改完。更精细的做法是先用CtrlD逐个选中确认再按CtrlShiftL全选。这样每一步都能看到选中范围避免正则写错导致误替换。我一般会先在一个文件上试确认没问题再应用到整个工作区。5.3 配置文件版本化换台机器五分钟恢复最后说一个习惯把 VS Code 的配置目录纳入版本管理。用户设置、快捷键、代码片段都在一个目录里不同系统路径不同系统配置目录Windows%APPDATA%\Code\UsermacOS~/Library/Application Support/Code/UserLinux~/.config/Code/User把这个目录里的settings.json、keybindings.json、snippets/复制到一个 Git 仓库换机器时克隆下来覆盖即可。注意不要复制workspaceStorage和globalStorage那些是缓存和扩展数据体积大且没必要同步。如果嫌手动麻烦VS Code 内置了 Settings Sync 功能用账号登录后自动同步。但内置同步有个问题它同步的是所有设置包括一些机器相关的路径换系统后可能冲突。我的做法是内置同步只开快捷键和代码片段设置文件手动管理这样可控性更强。这套工作流我用了很久最大的体会是VS Code 的配置不是一次性的而是随着你对项目理解加深不断调整的。刚开始可能只改字体和主题后来会加任务、加调试、加远程。每次觉得「这个操作好烦」的时候就是该把它自动化的时候。希望帮到你。本文还有配套的精品资源点击获取