您必须完成5个初始设置:一、启用自动保存并设UTF-8编码;二、安装ESLint等核心扩展;三、设zsh为默认终端;四、调整字体、字号与行高;五、配置用户代码片段。

如果您刚刚安装并首次启动 Visual Studio Code,界面可能显得空白且缺乏个性化配置,导致编辑效率低下。以下是您必须完成的 5 个初始设置:
本文运行环境:MacBook Air,macOS Sequoia。
一、启用自动保存与文件编码统一
VSCode 默认不自动保存文件,且可能因编码格式不一致导致中文乱码或 Git 提交异常。启用自动保存并统一设为 UTF-8 可避免多数基础文本问题。
1、点击左下角齿轮图标,选择“设置”(Settings)。
2、在搜索栏输入 files.autoSave,勾选“afterDelay”选项。
3、继续搜索 files.encoding,将其值设为 utf8。
4、再搜索 files.autoGuessEncoding,将其设为启用状态。
二、安装并启用核心扩展包
VSCode 的功能高度依赖扩展,首次启动后需快速安装语言支持、代码提示与格式化工具,否则无法获得现代编辑器应有的智能体验。
1、点击左侧活动栏的扩展图标(四个方块组成的图标)。
2、在搜索框中依次输入并安装:ESLint、Prettier、GitLens、Bracket Pair Colorizer。
3、安装完成后,重启 VSCode 使扩展完全生效。
三、配置用户级默认终端
内置终端是开发高频使用组件,若未指定默认终端类型,VSCode 可能在 macOS 上调用过时的 Terminal.app 或出现 Shell 初始化失败问题。
1、按下 Cmd + Shift + P 打开命令面板。
2、输入 Terminal: Select Default Profile 并回车。
3、从列表中选择 zsh(macOS Sequoia 默认 Shell)。
4、再次打开终端(Ctrl + `),确认提示符显示正常且可执行 git 命令。
四、调整工作区字体与行高
默认字体在高分屏上可能过小或发虚,行高不足则代码密集区域易误读。合理设置可显著提升长时间编码的视觉舒适度与可读性。
1、进入设置页面,搜索 editor.fontFamily,将其值改为 'Fira Code', 'JetBrains Mono', 'Consolas', 'monospace'。
2、搜索 editor.fontSize,设为 14。
3、搜索 editor.lineHeight,设为 24。
五、初始化用户 snippets 片段库
手动重复输入常用代码结构(如 console.log、React 函数组件模板)会降低效率。通过自定义代码片段,可一键插入标准化结构,减少语法错误风险。
1、按下 Cmd + Shift + P,输入 Configure User Snippets 并回车。
2、选择 New Global Snippets file,命名为 common.code-snippets。
3、在弹出的 JSON 文件中粘贴以下内容:
{
"log": {
"prefix": "log",
"body": ["console.log('$1');", "$2"],
"description": "Log output to console"
}
}










