适用人群与目标
这篇教程面向刚换电脑、重装系统或第一次用 VS Code 的人:我们不追求“装一堆插件”,而是用一套可复制的配置,把常见的卡点(语言支持、格式化、终端、同步)一次打通,让你在 30 分钟内恢复一个稳定、顺手、可迁移的开发环境。
第 1 步:安装 VS Code 与基础设置(先稳定,再花哨)
安装完成后,建议先做三件事:
- 检查自动更新:保持稳定版本即可,不必追新。
- 设置字体与字号:以“长时间阅读不累”为准,别只追求颜值。
- 打开设置同步入口(后面会用):把未来的配置变成“可搬家”。
如果你经常跨设备工作,建议把设置、快捷键、扩展列表纳入同步;而大型项目的依赖、编译产物不要靠同步解决,交给项目本身的依赖管理。
第 2 步:扩展装哪些?用“场景清单”替代“插件排行榜”
扩展选择可以按场景分组,避免装了不知为何而装:
- 通用效率:中文语言包(按需)、路径提示、Git 增强、图标主题(可选)。
- 代码质量:ESLint / Stylelint(前端)、Markdown Lint(写文档)。
- 格式化工具:Prettier(前端常用)、EditorConfig(团队一致性)。
- 语言支持:Python、Go、Java、C#、Rust 等按你实际项目选择;不要一次全装。
- 远程与容器:Remote - SSH、Dev Containers(有远程开发需求再上)。
经验法则:能由“项目配置文件”约束的,就尽量交给项目(例如 eslint/prettier 配置);仅与个人习惯相关的,放在用户设置里(例如主题、字体、窗口布局)。
第 3 步:格式化与保存策略(把“统一风格”变成默认行为)
想让团队协作少扯皮,关键在“保存即修复”。推荐你按项目分两层:
- 项目层:在仓库里加入 EditorConfig / Prettier / ESLint 等配置,保证所有人一致。
- 个人层:在 VS Code 里开启保存时格式化,并把“默认格式化器”指定清楚,避免多个扩展互相抢。
如果遇到保存后格式乱跳、或某些文件不该格式化(如压缩后的 JSON、第三方代码),用忽略规则排除它们,比关掉整个功能更合理。
第 4 步:终端、任务与运行(让“跑起来”不再靠记忆)
很多人换机后最痛苦的是:命令行、脚本、运行入口全散了。建议做两件事:
- 统一终端:选择你常用的 Shell(PowerShell / bash / zsh 等),并把工作目录、编码与字体调整到舒服。
- 沉淀任务:把常用命令写成 VS Code 任务(Tasks),例如:安装依赖、启动开发服务、运行测试、打包构建。
好处是:你不需要每次记住命令,也不怕新同事或未来的你“忘了怎么启动项目”。任务配置保存在项目中,天然可共享。
第 5 步:设置同步与多设备一致性(真正的“新电脑秒恢复”)
VS Code 的设置同步能同步:设置、快捷键、扩展、代码片段等。推荐做法:
- 先在旧设备“整理一遍”:清掉不用的扩展与快捷键冲突。
- 再在新设备登录同步:让配置自动落地,减少手工复制。
- 遇到公司/个人账号混用:建议按场景拆分(例如工作一个账号、个人一个账号),避免同步污染。
注意:同步解决的是“编辑器习惯”,不是“项目依赖”。语言运行时(如 Python/Node/Go)仍需按项目要求安装对应版本,建议用版本管理工具或容器来固定环境,但不要把它理解成“同步能搞定一切”。
常见问题排查(5 分钟自检)
- 格式化不生效:检查是否安装了多个格式化器,是否为当前语言设置了默认格式化器。
- Lint 报错一堆:优先确认项目依赖是否安装完整,以及配置文件是否在仓库根目录。
- 终端乱码:检查字体、编码与 shell 配置;Windows 场景下尤其要留意编码一致性。
- 同步后扩展缺失:确认同步开关是否包含“Extensions”,以及是否使用了同一个账号。
- 新电脑跑不起来:先从 README 或任务入口开始,不要直接猜命令;把可运行步骤写进任务里最省事。
最后给你一份“新电脑上手清单”
- 安装 VS Code,并完成基础设置(字体、自动更新、同步入口)。
- 按场景安装扩展(通用/格式化/语言/远程),避免一次装满。
- 配置保存策略:保存即格式化、保存即修复(按项目需要)。
- 把常用命令固化成 Tasks(安装、启动、测试、构建)。
- 开启设置同步,并在新旧设备上核对扩展与快捷键一致性。
做到这一步,你的 VS Code 环境就具备了“可复制、可迁移、可协作”的三个关键属性:不怕重装、不怕换机、不怕团队风格不统一。