VS Code — 最受欢迎的开源代码编辑器完全指南

由微软开发的免费开源代码编辑器 — 支持数百种语言、丰富插件生态、内置 Git、智能补全与远程开发

⭐ 168,000+ Stars GitHub 官网 文档

项目介绍

Visual Studio Code（简称 VS Code）是由微软开发的一款免费、开源的代码编辑器。自 2015 年发布以来，VS Code 已经迅速成为全球最受欢迎的代码编辑器，在 Stack Overflow 开发者调查中连续多年蝉联第一。它支持几乎所有主流编程语言，拥有庞大的扩展市场，并且提供了 IntelliSense 智能补全、内置调试器、集成终端、Git 集成等专业级功能。

VS Code 基于 TypeScript 和 Electron 构建，跨平台支持 Windows、macOS 和 Linux。它的核心优势在于轻量与强大的完美平衡 — 启动速度快如编辑器，功能强大如 IDE。通过丰富的扩展生态，VS Code 可以支持从前端开发、后端编程到数据科学、嵌入式开发等几乎所有开发场景。

项目信息详情
开发团队Microsoft
GitHub Stars168,000+
官方网站code.visualstudio.com
开源协议MIT License
技术栈TypeScript / Electron
支持平台Windows / macOS / Linux / Web
扩展市场50,000+ 扩展
一句话理解：VS Code 是一个"披着编辑器外衣的 IDE" — 拥有编辑器的轻量和速度，同时通过扩展获得 IDE 级别的强大功能，而且完全免费开源。

VS Code vs Sublime Text vs WebStorm vs Vim/Neovim

对比维度 VS Code Sublime Text WebStorm Vim/Neovim
价格 免费开源 $99 买断（可免费试用） $69/年 订阅 免费开源
开源 MIT 开源 闭源 闭源 开源
启动速度 中等（1-3 秒） 极快（<1 秒） 较慢（5-10 秒） 极快（<1 秒）
内存占用 中等（300-500 MB） 低（50-100 MB） 高（1-2 GB） 极低（10-50 MB）
插件生态 50,000+ 扩展 5,000+ 插件 内置 + JetBrains 市场 丰富但配置复杂
智能补全 IntelliSense（强大） 基础补全 开箱即用（最强） 需配置 LSP
调试功能 内置强大调试器 无内置调试 开箱即用 需额外配置
远程开发 Remote SSH / Container / WSL 不支持 Gateway 远程 原生 SSH 支持
学习曲线 简单 简单 中等 陡峭
适用人群 大多数开发者 追求极致速度 专业 JetBrains 用户 终端高手 / 服务器运维
选择建议：对于大多数开发者，VS Code 是最佳的"全能选手"。如果追求极致启动速度，选 Sublime Text；如果需要开箱即用的重量级 IDE 体验，选 WebStorm；如果是终端爱好者，Vim/Neovim 是终极选择。

安装配置

步骤 1 下载安装

前往 code.visualstudio.com 下载适合你操作系统的安装包。也可以通过命令行安装： 
# macOS (Homebrew)
brew install --cask visual-studio-code

# Windows (winget)
winget install Microsoft.VisualStudioCode

# Ubuntu/Debian
sudo apt install code

# Arch Linux
sudo pacman -S code
提示：安装时建议勾选"添加到 PATH"选项，这样就可以在终端中使用 code . 命令直接打开项目。

步骤 2 settings.json 核心配置

按 Ctrl+Shift+P（macOS: Cmd+Shift+P）打开命令面板，输入 Open User Settings (JSON) 编辑配置文件。以下是推荐的基础配置：
// settings.json 推荐配置 { "editor.fontSize": 14, "editor.tabSize": 2, "editor.wordWrap": "on", "editor.formatOnSave": true, "editor.defaultFormatter": "esbenp.prettier-vscode", "editor.minimap.enabled": false, "editor.cursorBlinking": "smooth", "editor.cursorSmoothCaretAnimation": "on", "editor.smoothScrolling": true, "editor.bracketPairColorization.enabled": true, "editor.guides.bracketPairs": "active", "files.autoSave": "afterDelay", "files.autoSaveDelay": 1000, "workbench.startupEditor": "none", "terminal.integrated.fontSize": 13, "explorer.confirmDelete": false }

步骤 3 主题与配色

VS Code 内置多种主题，也可以从扩展市场安装。推荐主题：

深色主题：
- One Dark Pro — 最受欢迎的深色主题，Atom 风格
- Dracula Official — 经典吸血鬼配色
- GitHub Dark — GitHub 风格深色
- Tokyo Night — 柔和的深色主题

浅色主题：
- GitHub Light — GitHub 风格浅色
- Atom One Light — 清爽浅色主题

切换主题：Ctrl+K Ctrl+T（macOS: Cmd+K Cmd+T）

步骤 4 字体推荐

编程字体对代码阅读体验至关重要。推荐以下等宽编程字体：

免费字体：
- Fira Code — 支持连字（Ligatures），!= => => 等符号更美观
- JetBrains Mono — JetBrains 出品，清晰易读
- Cascadia Code — 微软官方编程字体
- Source Code Pro — Adobe 出品

配置字体和连字支持：
{ "editor.fontFamily": "'Fira Code', 'JetBrains Mono', Consolas, monospace", "editor.fontLigatures": true, "editor.fontSize": 14, "editor.lineHeight": 1.6 }

必装插件

以下 10 个扩展覆盖了代码质量、版本控制、API 测试、远程开发、AI 辅助等核心场景，建议每位开发者都安装。

01 ESLint

JavaScript / TypeScript 代码检查工具，实时在编辑器中标记语法错误和代码风格问题。

安装：在扩展市场搜索 dbaeumer.vscode-eslint 并安装。
配置：项目根目录需有 .eslintrc 配置文件。推荐在 settings.json 中添加：
{ "editor.codeActionsOnSave": { "source.fixAll.eslint": "explicit" }, "eslint.validate": ["javascript", "typescript", "javascriptreact", "typescriptreact"] }

02 Prettier - Code Formatter

代码格式化工具，支持 JavaScript、TypeScript、CSS、HTML、JSON、Markdown 等多种语言，团队协作统一代码风格的必备工具。

安装：搜索 esbenp.prettier-vscode 并安装。
配置：设置为默认格式化工具并开启保存时格式化：
{ "editor.defaultFormatter": "esbenp.prettier-vscode", "editor.formatOnSave": true }

03 GitLens

Git 增强工具，在代码行内直接显示 Git blame 信息（谁在什么时候改了这行代码），支持文件历史、分支对比、交互式 rebase 等功能。

安装：搜索 eamodio.gitlens 并安装。
功能亮点：
- 行内 Blame 注解：鼠标悬停可看到提交信息
- 文件历史时间线
- 分支和标签可视化对比
- 搜索提交、比较分支差异

04 Thunder Client

轻量级 REST API 客户端，类似 Postman 但直接集成在 VS Code 中，无需切换窗口即可测试 API。

安装：搜索 rangav.vscode-thunder-client 并安装。
功能：
- 发送 GET / POST / PUT / DELETE 等 HTTP 请求
- 支持环境变量和集合管理
- 请求历史记录
- 支持 GraphQL 请求

05 Remote - SSH

通过 SSH 连接到远程服务器，在本地 VS Code 中直接编辑远程文件、运行终端命令、调试程序，体验与本地开发完全一致。

安装：搜索 ms-vscode-remote.remote-ssh 并安装。
使用：按 F1 输入 Remote-SSH: Connect to Host，输入 user@hostname 即可连接。

06 Docker

Docker 容器管理扩展，提供容器、镜像、网络、卷的可视化管理，支持 Dockerfile 和 docker-compose.yml 的语法高亮与智能补全。

安装：搜索 ms-azuretools.vscode-docker 并安装。
功能：
- 侧边栏查看和管理容器/镜像
- 一键启动/停止/删除容器
- Dockerfile 智能补全和错误检测
- docker-compose 一键 up/down

07 GitHub Copilot

AI 代码补全和聊天助手，基于 GPT 模型，可以根据注释和上下文自动生成代码，极大提升编码效率。

安装：搜索 GitHub.copilot 并安装。需要 GitHub Copilot 订阅（$10/月，学生免费）。
功能：
- 智能代码补全（Tab 接受建议）
- Copilot Chat 内置对话（解释代码、生成测试、重构）
- 支持几乎所有编程语言
- 内联聊天：选中代码后 Ctrl+I 直接对话

08 Tailwind CSS IntelliSense

Tailwind CSS 官方扩展，提供类名自动补全、悬停预览实际 CSS 样式、语法高亮和 Lint 检查。前端开发者使用 Tailwind 必装。

安装：搜索 bradlc.vscode-tailwindcss 并安装。
功能：
- 类名自动补全和模糊搜索
- 鼠标悬停预览实际 CSS 属性
- 类名排序（Tailwind CSS: Sort Classes）
- 支持自定义 tailwind.config.js 配置

09 Error Lens

将错误和警告信息直接内联显示在代码行尾，无需鼠标悬停即可一目了然地看到所有问题，极大提高排错效率。

安装：搜索 usernamehw.errorlens 并安装。
效果：错误用红色背景标记在行尾，警告用黄色背景，信息用蓝色背景，比默认的波浪线提示直观得多。

10 Live Server

为静态和动态页面启动一个带有实时重载功能的本地开发服务器。保存 HTML/CSS/JS 文件后浏览器自动刷新，前端开发利器。

安装：搜索 ritwickdey.LiveServer 并安装。
使用：右键点击 HTML 文件选择 Open with Live Server，或点击底部状态栏的 Go Live 按钮。默认端口 5500。

高效快捷键

以下快捷键以 Windows/Linux 为主，macOS 请将 Ctrl 替换为 Cmd，Alt 替换为 Option。

命令面板与文件导航

快捷键功能说明
Ctrl+Shift+P打开命令面板VS Code 最重要的快捷键，几乎所有操作都可以通过它完成
Ctrl+P快速打开文件输入文件名模糊搜索，按 Enter 打开
Ctrl+Shift+E聚焦资源管理器快速切换到文件树
Ctrl+B切换侧边栏隐藏/显示左侧侧边栏
Ctrl+\拆分编辑器左右分屏编辑不同文件
Ctrl+Tab切换已打开的文件在打开的标签页之间快速切换
Ctrl+`打开/关闭终端集成终端切换

多光标编辑

快捷键功能说明
Alt+Click添加光标在点击位置添加一个新光标
Ctrl+Alt+Up/Down上下添加光标在上方/下方添加光标，批量编辑多行
Ctrl+D选择下一个匹配项选中当前单词后，按 Ctrl+D 继续选中下一个相同的单词
Ctrl+Shift+L选择所有匹配项一次性选中文件中所有相同的单词
Alt+Shift+I在选中行尾添加光标先选中多行，再按此快捷键在每行末尾添加光标

代码导航

快捷键功能说明
F12跳转到定义跳转到函数/变量的定义位置
Alt+F12Peek 定义在内联窗口中预览定义，无需跳转
Shift+F12查看所有引用查看函数/变量在项目中的所有使用位置
Ctrl+Shift+O跳转到符号在当前文件中按函数名/类名跳转
Ctrl+G跳转到行输入行号直接跳转
Ctrl+Shift+\跳转到匹配括号在配对的大括号之间跳转
Alt+Left/Right前进/后退在浏览历史中前进和后退

搜索与替换

快捷键功能说明
Ctrl+F当前文件搜索在当前打开的文件中查找
Ctrl+H当前文件替换在当前文件中搜索并替换
Ctrl+Shift+F全局搜索在整个项目中搜索内容
Ctrl+Shift+H全局替换在整个项目中搜索并替换
Alt+Enter选中所有匹配结果在搜索框中按 Alt+Enter 选中所有匹配
Alt+R切换正则表达式在搜索框中启用/关闭正则模式

调试技巧

核心 launch.json 配置

按 F5 启动调试，首次运行会提示创建 launch.json 配置文件。该文件位于项目的 .vscode/ 目录下。

Node.js 调试配置示例：
// .vscode/launch.json { "version": "0.2.0", "configurations": [ { "type": "node", "request": "launch", "name": "启动程序", "program": "${workspaceFolder}/src/index.js", "console": "integratedTerminal", "skipFiles": ["<node_internals>/**"] } ] }

技巧 1 断点类型

VS Code 支持多种断点，不仅仅是普通断点：

普通断点：点击行号左侧的红点，程序运行到此处暂停。
条件断点：右键点击断点，选择"编辑断点"，输入条件表达式（如 i > 10），只有条件为真时才暂停。
日志断点（Logpoint）：右键行号左侧选择"添加日志点"，输入消息模板（如 x = {x}），不暂停程序只打印日志。
命中次数断点：设置断点在被命中 N 次后才暂停，适用于循环调试。
异常断点：在调试面板中勾选"Caught Exceptions"或"Uncaught Exceptions"。

技巧 2 Watch 表达式

在调试侧栏的"监视（Watch）"面板中添加表达式，程序暂停时自动计算并显示值。可以监视变量、对象属性、甚至复杂表达式：

- user.name — 监视对象属性
- arr.length — 监视数组长度
- JSON.stringify(data, null, 2) — 格式化 JSON 输出
- typeof variable — 查看变量类型

提示：在调试控制台（Debug Console）中可以直接执行代码，修改变量值实时生效。

技巧 3 调试 Node.js

VS Code 对 Node.js 调试支持最好，开箱即用。除了 launch 模式，还可以 Attach 到已运行的进程： 
# 以调试模式启动 Node.js
node --inspect src/index.js

# 启动并等待调试器连接
node --inspect-brk src/index.js
然后在 VS Code 中按 F5 选择"Attach to Node Process"。

调试 TypeScript：确保 tsconfig.json 中设置了 "sourceMap": true，VS Code 会自动映射 TS 和 JS 文件。

技巧 4 调试 Python

安装 ms-python.python 扩展后即可调试 Python。launch.json 配置：
{ "type": "debugpy", "request": "launch", "name": "Python: 当前文件", "program": "${file}", "console": "integratedTerminal", "justMyCode": true }
设置 "justMyCode": false 可以调试第三方库的源代码。

技巧 5 调试 Go

安装 golang.go 扩展后，使用 Delve 调试器调试 Go 程序。launch.json 配置：
{ "type": "go", "request": "launch", "name": "Launch Go", "mode": "auto", "program": "${fileDirname}" }
提示：Go 扩展会自动安装 gopls（语言服务器）和 dlv（调试器），无需手动配置。

远程开发

VS Code 的远程开发功能是其最具竞争力的特性之一，让你在本地编辑器中无缝操作远程环境。

方式 1 Remote - SSH

通过 SSH 连接到任何远程 Linux/macOS 服务器，在本地 VS Code 中编辑远程文件、运行终端、调试程序，体验与本地完全一致。

配置步骤：
1. 安装 Remote - SSH 扩展
2. 按 F1 输入 Remote-SSH: Connect to Host
3. 输入 user@hostname 并回车
4. 首次连接会在远程服务器上安装 VS Code Server

SSH 配置文件优化（~/.ssh/config）：
Host my-server HostName 192.168.1.100 User root Port 22 IdentityFile ~/.ssh/id_rsa ForwardAgent yes
配置后只需选择 my-server 即可一键连接。

方式 2 Dev Containers

使用 Docker 容器作为开发环境，确保团队所有成员使用完全一致的开发环境，彻底解决"在我的电脑上可以运行"的问题。

配置步骤：
1. 安装 Dev Containers 扩展
2. 在项目根目录创建 .devcontainer/devcontainer.json
3. 按 F1 输入 Dev Containers: Reopen in Container

devcontainer.json 示例：
{ "name": "Node.js 开发环境", "image": "mcr.microsoft.com/devcontainers/javascript-node:20", "features": { "ghcr.io/devcontainers/features/git:1": {} }, "customizations": { "vscode": { "extensions": ["dbaeumer.vscode-eslint", "esbenp.prettier-vscode"] } }, "forwardPorts": [3000], "postCreateCommand": "npm install" }

方式 3 WSL（Windows Subsystem for Linux）

Windows 用户可以在 WSL 中获得原生 Linux 开发体验，同时使用 VS Code 的 GUI 界面。

配置步骤：
1. 安装 WSL 扩展
2. 在 Windows 终端中进入 WSL：wsl
3. 在 WSL 终端中输入 code . 即可在 VS Code 中打开当前目录

建议：将项目文件存放在 WSL 文件系统中（如 ~/projects/），而非 Windows 文件系统（/mnt/c/），这样文件 I/O 性能会快 5-10 倍。

方式 4 GitHub Codespaces

GitHub 提供的云端开发环境，在浏览器或本地 VS Code 中一键打开任何 GitHub 仓库的完整开发环境，无需本地配置。

使用方式：
1. 在 GitHub 仓库页面点击绿色 Code 按钮，选择 Codespaces 标签
2. 点击 Create codespace on main
3. 等待环境构建完成后即可在浏览器中使用完整的 VS Code
4. 也可以在本地 VS Code 中通过 GitHub Codespaces 扩展连接

注意：GitHub Codespaces 免费账户每月有 120 核心小时的免费额度（2 核心机器 = 60 小时），超出后按时计费。

常见问题

以下整理了 VS Code 使用中最常遇到的 50 个问题及解决方案，按类别分类。

一、扩展与插件 （10 个）

#1 扩展无法加载 / 扩展 Host 崩溃

Extension host terminated unexpectedly. Please reload the window.
1. 按 Ctrl+Shift+P 输入 Reload Window 重新加载
2. 如果持续崩溃，尝试禁用最近安装的扩展
3. 启动时禁用所有扩展：code --disable-extensions
4. 查看扩展日志：Help > Toggle Developer Tools > Console

#2 扩展安装失败 / 市场无法连接

Error while fetching extensions. XHR failed
1. 检查网络连接，VS Code 扩展市场域名：marketplace.visualstudio.com
2. 如果在公司网络，配置代理："http.proxy": "http://proxy:port"
3. 手动下载 .vsix 文件后离线安装：code --install-extension xxx.vsix

#3 扩展之间冲突导致功能异常

多个格式化扩展同时生效，保存时格式不一致
1. 在 settings.json 中明确指定默认格式化工具： 
"editor.defaultFormatter": "esbenp.prettier-vscode"
2. 为不同语言指定不同的格式化工具： 
"[python]": { "editor.defaultFormatter": "ms-python.black-formatter" }
3. 使用 Format Document With... 命令查看可用的格式化工具

#4 扩展推荐功能过于打扰

VS Code 频繁弹出扩展推荐通知
在 settings.json 中添加以下配置关闭推荐： 
"extensions.ignoreRecommendations": true,
"extensions.showRecommendationsOnlyOnDemand": true

#5 扩展占用过多内存

VS Code 内存占用持续增长，超过 2GB
1. 按 Ctrl+Shift+P 输入 Process Explorer 查看各进程内存占用
2. 禁用不常用的扩展（特别是 AI 相关的扩展）
3. 使用工作区扩展推荐，只在需要的项目中启用特定扩展
4. 重启 VS Code 释放内存

#6 扩展更新后功能异常

扩展更新到新版本后出现 Bug 或功能缺失
1. 在扩展页面点击齿轮图标，选择"Install Another Version"回退到旧版本
2. 关闭自动更新："extensions.autoUpdate": false
3. 到扩展的 GitHub 仓库查看 Issue 确认是否为已知 Bug

#7 ESLint 扩展不工作

ESLint 没有显示任何错误提示，状态栏显示感叹号
1. 确认项目中已安装 ESLint：npm install eslint --save-dev
2. 确认存在 ESLint 配置文件（.eslintrc.js / eslint.config.js）
3. 点击状态栏的 ESLint 图标查看详细错误信息
4. 在 Output 面板选择 ESLint 查看日志

#8 Prettier 与 ESLint 规则冲突

保存时 Prettier 格式化后 ESLint 报错，ESLint 修复后 Prettier 又重新格式化
安装 eslint-config-prettier 关闭 ESLint 中与 Prettier 冲突的规则： 
npm install eslint-config-prettier --save-dev
在 ESLint 配置中添加： 
{ "extends": ["eslint:recommended", "prettier"] }

#9 Python 扩展找不到解释器

Python interpreter not found. Please select a Python interpreter.
1. 按 Ctrl+Shift+P 输入 Python: Select Interpreter
2. 选择正确的 Python 路径（系统 Python 或虚拟环境）
3. 如果使用 venv，确保在项目目录下激活虚拟环境后再打开 VS Code
4. 手动指定路径："python.defaultInterpreterPath": "/usr/bin/python3"

#10 TypeScript 类型检查与扩展版本不一致

VS Code 使用内置 TypeScript 版本与项目版本不一致，导致类型错误
让 VS Code 使用项目的 TypeScript 版本：
1. 按 Ctrl+Shift+P 输入 TypeScript: Select TypeScript Version
2. 选择 Use Workspace Version
3. 或在 settings.json 中配置："typescript.tsdk": "node_modules/typescript/lib"

二、性能与资源 （10 个）

#11 VS Code 启动缓慢

打开 VS Code 需要 10 秒以上
1. 按 Ctrl+Shift+P 输入 Startup Performance 查看各阶段耗时
2. 禁用不必要的扩展（特别是启动时激活的扩展）
3. 关闭自动恢复上次会话："window.restoreWindows": "none"
4. 减少工作区中的文件数量，使用 files.exclude 排除不需要的目录

#12 CPU 占用率持续 100%

VS Code 进程长时间占满 CPU，风扇狂转
1. 打开 Process Explorer（Ctrl+Shift+P > Process Explorer）找出高 CPU 进程
2. 常见原因：TypeScript 语言服务器在大项目中索引、搜索索引正在构建
3. 在 files.watcherExclude 中排除 node_modules 等大目录： 
"files.watcherExclude": {
  "**/node_modules/**": true,
  "**/.git/**": true,
  "**/dist/**": true
}
4. 限制 TypeScript 内存："typescript.tsserver.maxTsServerMemory": 3072

#13 大文件打开卡顿或崩溃

打开超过 100MB 的日志文件时 VS Code 无响应
1. VS Code 默认限制打开大文件，可调整："editor.largeFileOptimizations": true
2. 对于超大文件，建议使用命令行工具（less、tail）或专用大文件编辑器
3. 关闭文件的语法高亮和小地图可以减少内存占用
4. 增大内存限制：启动参数 --max-memory=8192

#14 编辑时输入延迟明显

打字时有明显的输入延迟（input latency > 100ms）
1. 关闭不必要的功能： 
"editor.minimap.enabled": false,
"editor.renderWhitespace": "none",
"editor.renderControlCharacters": false,
"editor.suggestOnTriggerCharacters": false
2. 禁用动画："workbench.list.smoothScrolling": false
3. 检查是否有扩展在频繁触发诊断
4. 在 GPU 渲染有问题的设备上禁用："disable-hardware-acceleration": true

#15 文件搜索速度很慢

Ctrl+Shift+F 全局搜索卡顿，结果加载缓慢
1. 在 search.exclude 中排除不需要搜索的目录： 
"search.exclude": {
  "**/node_modules": true,
  "**/dist": true,
  "**/build": true,
  "**/.git": true
}
2. 使用 files to include 缩小搜索范围
3. 开启 ripgrep 搜索（默认已开启）："search.useRipgrep": true

#16 工作区信任对话框频繁弹出

每次打开文件夹都提示"是否信任此文件夹的作者？"
如果你确定自己打开的目录都是安全的： 
"security.workspace.trust.enabled": false
注意：关闭工作区信任会降低安全性，打开不受信任的项目时扩展可能执行恶意代码。建议仅在个人设备上关闭。

#17 自动保存导致文件频繁写入

开启 autoSave 后，文件监听工具（webpack/vite）频繁触发重新构建
将自动保存延迟调大： 
"files.autoSave": "afterDelay",
"files.autoSaveDelay": 2000
或改为焦点变化时保存："files.autoSave": "onFocusChange"

#18 VS Code 频繁崩溃重启

VS Code 意外关闭，重启后提示"VS Code crashed"
1. 更新到最新版本：Help > Check for Updates
2. 清除缓存：删除 ~/.config/Code/Cache（Linux）或 %APPDATA%\Code\Cache（Windows）
3. 重置用户数据：code --user-data-dir /tmp/vscode-test 测试是否为配置问题
4. 检查 GPU 驱动是否最新，或禁用 GPU 加速：code --disable-gpu

#19 文件监视器达到上限

Visual Studio Code is unable to watch for file changes in this large workspace (error ENOSPC)
Linux 系统文件监视器默认限制较低。增大限制： 
# 临时增大
sudo sysctl fs.inotify.max_user_watches=524288

# 永久增大
echo "fs.inotify.max_user_watches=524288" | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

#20 打开多个项目窗口后内存不足

同时打开 4-5 个 VS Code 窗口后系统内存接近满
1. 使用多根工作区（Multi-root Workspace）代替多窗口：File > Add Folder to Workspace
2. 每个窗口只启用必要的扩展
3. 关闭不活跃的窗口
4. 增加系统虚拟内存/交换分区

三、终端相关 （10 个）

#21 终端字体显示乱码 / 图标缺失

终端中使用 Oh My Zsh / Starship 时图标显示为方块
安装 Nerd Font 并配置终端字体：
1. 从 nerdfonts.com 下载并安装字体（推荐 MesloLGS NF）
2. 在 settings.json 中配置： 
"terminal.integrated.fontFamily": "MesloLGS NF"

#22 终端默认 Shell 不正确

Windows 上默认打开 PowerShell 而非 Git Bash
在 settings.json 中指定默认终端： 
// Windows 使用 Git Bash
"terminal.integrated.defaultProfile.windows": "Git Bash"

// 或指定自定义路径
"terminal.integrated.profiles.windows": {
  "Git Bash": {
    "path": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

#23 终端环境变量与系统不一致

在 VS Code 终端中 nvm/pyenv/conda 等命令不可用
1. VS Code 终端可能未加载 shell 配置文件。确保使用登录 shell： 
"terminal.integrated.profiles.linux": {
  "bash": {
    "path": "/bin/bash",
    "args": ["-l"]
  }
}
2. 或在 settings.json 中设置："terminal.integrated.inheritEnv": true
3. 完全退出 VS Code 后重新打开（不是 Reload Window）

#24 终端输出颜色不正确

终端中 ls、git diff 等命令输出没有颜色
1. 确认终端类型设置正确："terminal.integrated.env.linux": { "TERM": "xterm-256color" }
2. 对于 Git：git config --global color.ui auto
3. 检查 shell 配置文件中是否有 export TERM=xterm-256color

#25 终端无法使用 Ctrl+C 复制

在终端中按 Ctrl+C 总是发送中断信号而非复制文本
在有文本选中时让 Ctrl+C 执行复制： 
"terminal.integrated.copyOnSelection": true
或配置快捷键使 Ctrl+C 在有选中内容时复制，否则发送中断： 
"terminal.integrated.sendKeybindingsToShell": false

#26 终端历史记录不够长

终端输出超出缓冲区，无法向上滚动查看之前的输出
增大终端回滚缓冲区： 
"terminal.integrated.scrollback": 10000
默认值为 1000 行。如果需要保存完整输出，可以使用 Terminal: Export 命令导出终端内容。

#27 终端分屏后宽度太窄

终端拆分后每个面板太窄，命令输出换行混乱
1. 将终端移到编辑器区域：右键终端标签 > Move Terminal into Editor Area
2. 使用 Ctrl+` 最大化终端面板
3. 拖拽终端面板边缘调整大小
4. 设置终端最小宽度：调整 terminal.integrated.tabs.minWidth

#28 终端任务（Task）运行失败

配置的 tasks.json 任务执行时报错
检查 .vscode/tasks.json 配置： 
{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "build",
      "type": "shell",
      "command": "npm run build",
      "group": { "kind": "build", "isDefault": true },
      "problemMatcher": ["$tsc"]
    }
  ]
}
确保 command 在终端中可以正常运行，检查工作目录是否正确。

#29 终端自动激活虚拟环境失败

打开 Python 项目时终端没有自动激活 venv
1. 确保已设置 Python 解释器为虚拟环境中的 Python
2. 启用自动激活："python.terminal.activateEnvironment": true
3. 如果使用 conda："python.condaPath": "/path/to/conda"
4. 手动激活：source venv/bin/activate（Linux/macOS）或 venv\Scripts\activate（Windows）

#30 终端光标不可见或位置错误

终端中光标消失或输入位置与显示位置不一致
1. 切换终端渲染方式："terminal.integrated.gpuAcceleration": "off"
2. 调整终端行高："terminal.integrated.lineHeight": 1.1
3. 如果使用自定义 shell 提示符，检查 PS1 设置中是否正确使用了转义序列
4. 重新打开终端：Terminal: Create New Terminal

四、Git 与版本控制 （10 个）

#31 Git 未检测到仓库

源代码管理面板显示"No source control providers registered"
1. 确认已安装 Git：在终端运行 git --version
2. 配置 Git 路径："git.path": "/usr/bin/git"（或 Windows 上 Git 的安装路径）
3. 确认当前文件夹是 Git 仓库：git status
4. 启用 Git 功能："git.enabled": true

#32 Git 提交时要求输入用户名密码

每次 push 都提示输入 GitHub 用户名和密码
1. 使用 SSH 密钥代替 HTTPS：git remote set-url origin git@github.com:user/repo.git
2. 配置凭据管理器：git config --global credential.helper store
3. Windows 用户使用 Git Credential Manager：git config --global credential.helper manager
4. 使用 GitHub CLI 认证：gh auth login

#33 行尾符号冲突（CRLF vs LF）

Git 显示大量文件被修改，但实际只是行尾符号不同
1. 统一使用 LF：在 settings.json 中设置 "files.eol": "\n"
2. 配置 Git 自动转换：git config --global core.autocrlf input（Linux/macOS）
3. 在项目中创建 .gitattributes 文件： 
* text=auto eol=lf
*.bat text eol=crlf

#34 Git diff 显示 "No changes" 但文件已修改

修改了文件但源代码管理面板不显示变更
1. 检查文件是否在 .gitignore 中
2. 刷新 Git 状态：Ctrl+Shift+P > Git: Refresh
3. 检查 git.autoRepositoryDetection 设置
4. 在终端中运行 git status 确认

#35 合并冲突编辑器不显示

Git merge 后没有出现三方合并编辑器
1. 启用合并编辑器："git.mergeEditor": true
2. 在有冲突的文件上右键选择"Open Merge Editor"
3. 如果只想使用内联标记，设置："git.mergeEditor": false
4. 使用命令：Git: Accept All Current / Accept All Incoming

#36 GitLens 导致大仓库卡顿

在大型 Git 仓库中 GitLens 使 VS Code 变慢
减少 GitLens 功能以提升性能： 
"gitlens.codeLens.enabled": false,
"gitlens.currentLine.enabled": false,
"gitlens.hovers.enabled": false
或者只保留你需要的功能，禁用其余所有功能。

#37 Git 操作超时

Performing git operations in large repository... timeout
1. 对于大仓库，启用稀疏检出（sparse checkout）
2. 增加 Git 操作超时时间
3. 关闭自动获取："git.autofetch": false
4. 使用 git maintenance 优化仓库性能

#38 无法查看 Git 提交图

想查看分支图但内置功能不够直观
1. GitLens 提供了 Commit Graph 功能（需要 GitLens+ 版本）
2. 安装 Git Graph 扩展（mhutchie.git-graph）
3. 使用命令 Git Graph: View Git Graph 打开可视化分支图
4. 也可以在终端使用：git log --oneline --graph --all

#39 Commit Message 输入框太小

源代码管理面板的提交消息输入框只有一行
1. 拖拽输入框下边缘可以扩大
2. 使用全屏编辑器编写提交消息："git.useEditorAsCommitInput": true
3. 按 Ctrl+Enter 提交（无需手动点击对号按钮）

#40 .gitignore 文件不生效

已添加到 .gitignore 的文件仍然出现在变更列表中
文件已被 Git 追踪后，需要先从索引中移除： 
# 移除追踪但保留本地文件
git rm --cached filename

# 移除整个目录
git rm -r --cached directory/

# 重新提交
git commit -m "Remove tracked files from .gitignore"

五、远程开发与连接 （10 个）

#41 Remote SSH 连接失败

Could not establish connection to "hostname". The process tried to write to a nonexistent pipe.
1. 确认 SSH 命令行连接正常：ssh user@hostname
2. 检查 SSH 配置文件 ~/.ssh/config 格式是否正确
3. 清除远程服务器上的 VS Code Server：rm -rf ~/.vscode-server
4. 设置 "remote.SSH.useLocalServer": false
5. 查看详细日志：Output 面板 > Remote - SSH

#42 Remote SSH 连接后扩展不可用

连接远程服务器后本地安装的扩展不工作
远程开发时扩展分为本地扩展和远程扩展。需要在远程重新安装：
1. 打开扩展面板，在"SSH: hostname - Installed"区域安装需要的扩展
2. 或在 settings.json 中配置默认远程安装： 
"remote.SSH.defaultExtensions": [
  "dbaeumer.vscode-eslint",
  "esbenp.prettier-vscode"
]

#43 Dev Container 构建失败

Dev Containers: Failed to start container. Error: docker returned an error.
1. 确认 Docker 正在运行：docker ps
2. 检查 .devcontainer/devcontainer.json 语法是否正确
3. 清理 Docker 缓存重建：Dev Containers: Rebuild Container Without Cache
4. 检查 Docker 磁盘空间：docker system df
5. 查看构建日志中的具体错误信息

#44 WSL 扩展无法连接

WSL 窗口打开后显示"Resolving your WSL distribution..."然后超时
1. 确认 WSL 正常运行：在命令行输入 wsl
2. 更新 WSL：wsl --update
3. 删除 WSL 中的 VS Code Server：rm -rf ~/.vscode-server
4. 重启 WSL：wsl --shutdown 然后重新打开

#45 远程端口转发不工作

远程服务器启动了 Web 服务但本地无法通过 localhost 访问
1. 检查 Ports 面板（底部面板）是否已自动检测到端口
2. 手动添加端口转发：Ports 面板 > Forward a Port
3. 确认远程服务绑定的是 0.0.0.0 而非 127.0.0.1
4. 在 settings.json 中配置："remote.autoForwardPorts": true

#46 远程文件保存很慢

通过 Remote SSH 编辑文件时保存延迟 2-3 秒
1. 检查网络延迟：ping hostname
2. 使用 SSH 压缩：在 ~/.ssh/config 中添加 Compression yes
3. 关闭不必要的远程扩展减少网络通信
4. 使用 Remote - SSH: Settings 中的 remote.SSH.localServerDownload 优化传输

#47 Codespaces 容器启动超时

GitHub Codespace creation timed out
1. 检查 .devcontainer/devcontainer.json 中的 postCreateCommand 是否耗时过长
2. 使用预构建（Prebuild）加速启动：在仓库设置中启用 Codespaces Prebuild
3. 减小 Docker 镜像体积，使用更轻量的基础镜像
4. 检查 GitHub 状态页面是否有服务问题

#48 远程开发 SSH 连接频繁断开

Remote SSH 连接经常断开，提示"Reconnecting..."
在 ~/.ssh/config 中添加保活配置： 
Host *
  ServerAliveInterval 60
  ServerAliveCountMax 10
  TCPKeepAlive yes
同时在远程服务器的 /etc/ssh/sshd_config 中设置： 
ClientAliveInterval 60
ClientAliveCountMax 10

#49 远程服务器磁盘空间被 VS Code Server 占满

远程服务器 ~/.vscode-server 目录占用数 GB 空间
1. 清理旧版本：rm -rf ~/.vscode-server/bin/旧版本hash
2. 清理扩展缓存：rm -rf ~/.vscode-server/extensions/.cache
3. 只保留最新版本和必要的扩展
4. 设置定期清理的 cron 任务

#50 VS Code Web 版功能受限

在 vscode.dev 或 github.dev 中部分功能不可用
VS Code Web 版运行在浏览器中，存在以下限制：
1. 无法运行终端命令（没有后端服务器）
2. 部分扩展不支持 Web 环境
3. 调试功能受限
4. 如果需要完整功能，使用 GitHub Codespaces 代替（提供完整的远程开发环境）
5. 或使用本地 VS Code 桌面版连接远程