自从我开始带新人写代码就发现一个特别有意思的现象很多人电脑上装了 VSCode但用起来跟记事本差不多。打开文件、写几行代码、保存、关闭偶尔用鼠标点一下运行按钮。问为什么不装插件、不配置环境回答多半是不会怕弄坏装过但搞不懂。可另一边同一款软件在另一些人手里自动补全、远程开发、AI 结对编程、多光标编辑、Git 可视化操作行云流水效率差了不止一个量级。VSCode 官方免费、跨平台、插件生态庞大到吓人几乎是现在写代码的标配编辑器。但装了和会用之间隔着一整套工作流认知。这篇不打算写成逐项点击的操作手册而是按我实际带人、自己踩坑的经历把从安装到进阶的完整路径捋一遍。涉及 C/C、Python、Java、Markdown、Git、远程服务器、安卓模拟器连接、AI 编程助手接入这些高频需求都会覆盖到。1. 装对版本、做对初始化多数人的 VSCode 从第一步就歪了先别急着去搜索引擎找vscode下载很多人第一步就卡在版本选择上。VSCode 官网的下载入口其实分两种Stable稳定版和 Insiders内测版。新手无脑选 Stable 就行Insiders 每天更新、偶尔会有莫名其妙的 bug那是给喜欢尝鲜的人准备的。另外还有一个非常关键的坑官网默认给的是 User Installer用户安装版它不需要管理员权限装在当前用户目录下而 System Installer系统安装版会装到 Program Files需要管理员权限。日常使用选 User Installer 就够了公司电脑没有管理员权限的时候尤其好用。如果是 Windows 7 这种老系统就得注意了。官方新版 VSCode 早就停止支持 Win7如果你还在用老机器需要去官方文档的既往版本页面找 1.70 左右的旧版本装完之后最好把自动更新关掉否则哪天它自动升级完直接打不开那才叫欲哭无泪。装完之后的第一件事不是写代码而是打开设置面板快捷键Ctrl ,搜索 Auto Save把自动保存设为afterDelay。这一步极其重要多少人写代码写了半小时一断电全没了才想起没保存。默认 VSCode 是不自动保存的这是新手最容易忽略的初始化配置。然后是中文界面。装完默认是英文在国内几乎每个人都想先汉化。操作很简单左侧扩展图标方块加四个点的那个搜索 Chinese找到 Chinese (Simplified) Language Pack for Visual Studio Code这个插件由微软官方发布安装之后按提示重启界面就是中文了。这里有个细节这个插件本质上只是语言包不影响任何功能装不装纯粹看个人习惯。我自己现在反而习惯英文界面因为报错信息、文档、社区问答全是英文界面英文的话对应起来更顺。但给新人配置机器时我通通装中文包降低一开始的上手门槛。还有一件事容易忽略——工作区与缓存目录。默认情况下 VSCode 会把扩展、缓存全部塞进 C 盘用户目录长期用下来 C 盘空间会肉眼可见地缩水。如果你 C 盘紧张可以这样做在命令行里启动 VSCode 时加上--extensions-dir和--user-data-dir参数把它们指到 D 盘或其他空间充足的分区。例如code --extensions-dir D:\VSCode\extensions --user-data-dir D:\VSCode\data想省事的话直接右键桌面快捷方式在目标栏末尾追加这两个参数。这样扩展和缓存就都迁移到 D 盘了。这条对经常折腾插件的人尤其友好不然扩展装多了C 盘告急还得一个个排查。2. 插件不是装越多越好按场景配齐高频开发环境很多人打开扩展市场就兴奋看到什么火装什么最后装了几十个插件打开 VSCode 慢如蜗牛还互相冲突。真实情况是好插件解决具体问题垃圾插件只会制造新问题。我按使用场景给你一套精简配置每个都是经过实际项目检验的。通用增强类Settings Sync现在官方已内置同步功能登录 GitHub 或微软账号即可云同步——换电脑时一键拉回所有配置和插件强烈建议登录账号开启同步。Bracket Pair Colorizer的功能官方已经内置不需要另外装。如果你看到老教程推荐这个插件可以直接忽略。Path Intellisense自动补全文件路径写导入语句、配置路径时非常省心。Code Spell Checker拼写检查变量命名单词拼错时会有波浪线提示。C / C 一键配置网上搜vscode配置c/c环境的教程一大把但很多都过时了。现在的推荐路线是这样的安装 C/C 扩展微软官方出品名叫 C/C然后安装 C/C Extension Pack这会把调试器、智能提示、代码格式化全部带齐。编译器方面Windows 上用 MinGW-w64这里要注意选对版本别下到那种带广告的旧版安装包。我常用的方法是用 MSYS2 装 MinGW安装完成后把...\mingw64\bin目录加到系统 PATH 环境变量里。配置完成后在终端里执行gcc --version能正常输出版本号就说明环境通了。然后写一个 hello.c按F5选择 C (GDB/LLDB)VSCode 会自动生成launch.json和tasks.json再用Ctrl Shift P打开命令面板输入 C/C: Edit Configurations (UI) 设置编译器路径基本就完事了。这年头真的不需要手写一堆 JSON 配置了很多人还拿着 2019 年的教程教人手动改c_cpp_properties.json纯属浪费时间。有一个为啥 vscode 写 C 没有代码提示的经典问题绝大部分原因就是没装 C/C 扩展或者装了但没配置编译器路径。智能提示要靠扩展解析你的 include 路径编译器路径没指对自然什么都提示不出来。按上面流程重新走一遍问题立刻消失。Python 环境配置装 Python 扩展微软官方名为 Python它会顺带把 Pylance、Jupyter 等组件带进来。然后选择解释器Ctrl Shift P输入 Python: Select Interpreter选你当前虚拟环境或 conda 环境里的 python.exe。这步选不对后面所有导入、语法检查都会乱掉。查看 Python 函数参数时把光标移到函数名上按Ctrl Shift Space或者直接悬停VSCode 会弹出签名帮助显示每个参数的类型和含义。Pylance 的悬停提示做得很精细类型、文档、示例都有比某些 IDE 还好用。Java 环境配置如果是跑标准 Java 项目装 Extension Pack for Java微软官方JDK 装好、PATH 配好后它自动识别项目、启动语言服务。但如果你跟我一样做 JavaEE 方向的 Web 开发比如 Spring Boot 那套光靠这个插件包不太够还需要装 Spring Boot Extension Pack。这里有个常见问题运行 Java 时控制台输出中文乱码。原因是 Windows 控制台默认 GBK 编码而代码和文件是 UTF-8。解决方法是把运行配置里的 VM 参数加上-Dfile.encodingUTF-8或者在 launch.json 中设置console: externalTerminal之前先在系统里把代码页切到 UTF-8chcp 65001。我现在一般直接改启动配置一劳永逸。C# 配置做 C# 开发装上微软官方的 C# Dev Kit 即可。它跟 .NET SDK 配合得很好F5 直接运行调试不用像以前那样手动配置一堆 JSON。这里提醒一句除非你搞的是 Unity否则别乱装 Omnisharp 相关的老扩展容易跟新扩展抢语言服务结果两边都起不来。Markdown 增强VSCode 内置 Markdown 预览但想写得更舒服有几个插件值得装Markdown All in One自动目录、快捷键、表格格式化、markdownlint语法规范检查。写技术文档、README、博客草稿时这组合非常顺手。另外打开 Markdown 预览的快捷键是Ctrl Shift V记住这个能省很多鼠标移动。3. 高频操作与快捷键为什么别人用 VSCode 像飞一样很多人觉得 VSCode 用起来没比记事本强多少是因为他们不知道真正的效率操作。快捷键是入门第一关但真正拉开差距的是多光标编辑、命令面板、文件切换这几个核心能力。多光标编辑把光标放在一个词上按Ctrl DVSCode 会选中下一个相同的词继续按就继续多选。当你想一次性修改多处类似的变量名、批量加前缀后缀时这招比用查找替换灵活得多。还有更进阶的组合键按住Alt键再用鼠标点击可以任意位置创建多个光标Ctrl Alt 下箭头可以在连续行上创建光标适合同时编辑多行数据。我举一个实际例子有一次我拿到一个 JSON 文件里面有几百个字段需要加上required: true。用多光标选中每行末尾然后一次性输入十秒钟搞定手动改要改半小时。命令面板Ctrl Shift P是 VSCode 里最重要的一组快捷键没有之一。几乎所有功能都可以通过命令面板触发打开设置、安装扩展、切换主题、运行任务、Git 操作、格式化代码…… 很多新手碰到问题就去百度怎么打开某某设置其实直接在命令面板里输入关键词就行。学会命令面板等于你不再依赖菜单栏和记忆所有操作都可以搜索。文件切换与快速跳转Ctrl P可以快速打开文件输入文件名的一部分就能模糊匹配。文件多了以后用鼠标在资源管理器里点来点去非常低效这个快捷键能救你一命。Ctrl Tab在最近打开的文件之间循环切换Ctrl Shift O可以跳转到文件中的符号函数、类、变量Ctrl G跳到指定行。代码折叠与格式化Ctrl Shift [折叠当前代码块Ctrl Shift ]展开。格式化快捷键是Shift Alt FWindows它会根据当前语言的格式化插件统一处理缩进、换行、空格。团队协作时统一格式化配置可以避免大量无效 diff。在项目根目录放一个.editorconfig文件VSCode 会自动读取团队里所有人都能保持一致的代码风格。编辑技巧补充Alt 上箭头 / 下箭头移动当前行或选中块的位置。Shift Alt 上箭头 / 下箭头向上或向下复制当前行。Ctrl /行注释Shift Alt A块注释。Ctrl Shift L选中当前所有匹配项同时编辑所有位置。用熟了这些之后你再回去看那些鼠标点来点去的人会难以理解他们是怎么忍受这种效率的。4. 真正拉开差距的功能远程开发、WSL 与 SSH 服务器连接如果你以为 VSCode 只能写本地代码那就错过了它最有价值的功能之一——远程开发。这个功能通过 Remote Development 扩展包实现支持三种场景WSL、SSH、容器Dev Containers。我逐个说。WSL 场景Windows 上写 Linux 代码或有 Linux 部署环境的人绕不开 WSL。先在安装 WSL 发行版比如 Ubuntu然后在 VSCode 里装 Remote - WSL 扩展左下角会出现一个绿色的连接图标点它就能选择 WSL 发行版点击后 VSCode 会在 WSL 里安装一个服务端随后你就进入了 Linux 环境的开发界面。文件系统、终端、调试器全部跑在 Linux 里但界面还是 VSCode 的。我经常推荐这个组合Windows 写代码 WSL 编译运行。比如 C/C 项目用 GCC 在 Linux 下编译行为跟生产环境一致避免我这能编译、你那不行的坑。终端可以直接用 WSL 的 bash装 Python 包用 pip 也不怕污染 Windows 的 Python。SSH 连接远程服务器做后端开发、算法训练、部署服务的人经常需要在一台 Linux 服务器上改代码。以前的做法是 ssh 进去用 vim痛苦指数拉满。现在直接装 Remote - SSH 扩展然后F1打开命令面板输入 Remote-SSH: Connect to Host填上userip输入密码或使用密钥登录VSCode 就会在远程服务器上装一个轻量服务端然后你就可以像操作本地文件一样操作服务器上的代码支持智能提示、调试、终端完整体验只是运行环境在远端。这里有一个必须掌握的进阶配置SSH 免密登录。在本地执行ssh-keygen -t rsa -b 4096 ssh-copy-id userip把公钥推送到服务器之后登录就不用每次输密码了。如果你管理多台服务器可以在~/.ssh/config里配置别名Host myserver HostName 192.168.1.100 User root Port 22 IdentityFile ~/.ssh/id_rsa配置之后连接时直接输myserver就可以。这样 VSCode 连接远程服务器、SCP 传输文件、SSH 登录全部统一管理不需要再去装额外的文件传输工具。有个常见问题连接服务器后代码提示失效或者跳转不到定义。绝大多数原因是远程服务器上没有装对应的语言扩展。Remote-SSH 模式下扩展分成本地 UI 扩展和远程工作区扩展两类像 C/C、Python、Pylance 这些必须安装在远程。你可以在扩展面板里看到分组确保远程那一组里有你需要的语言扩展。这个问题是vscode无法跳转到定义的主要来源之一。5. Git 可视化操作分支管理、清理远端分支与冲突处理VSCode 的 Git 集成是被严重低估的功能。很多人还是开着命令行敲git add .、git commit -m xx、git push。这当然没问题但 VSCode 的图形化 Git 操作真的能让日常流程轻快很多尤其是查看 diffs、处理冲突、管理分支这些场景。源码管理面板左侧第三个图标分支符号就是源码管理面板它显示所有变更文件、暂存区状态。修改文件后在文件上点加号就执行了git add在消息框输入提交信息点 提交 就执行了 commit点 同步更改 就是 pull push。这些操作完全可以在界面里完成配合快捷键Ctrl Enter提交。实际上用了这个之后我再也没为提交代码切过命令行合并复杂分支除外。分支管理点击左下角的当前分支名或者用Ctrl Shift P输入 Git: Checkout to就能切分支、建分支、删除本地分支。图形化的分支视图在源代码管理面板顶部有个分支按钮点开可以看到本地分支和远端分支的树形结构当前在哪个分支一目了然。清理已删除的远端分支这个需求非常实际。你在本地执行git fetch --prune之后远端已经删除但本地缓存里还残留一堆origin/xxx分支。许多人不知道线下怎么删我告诉你一个 VSCode 视觉化方案在源码管理面板的分支视图里展开远程分组找到那些带打叉标记或者已经不存在的远端分支右键选择 Delete Remote Branch 或者 Prune。不过更可靠的做法还是命令行git remote prune origin这个命令会清理本地记录的、远端已经不存在的分支引用。做开发久了这个命令最好形成肌肉记忆它不会误删任何本地工作分支只清理远端已消失的追踪引用。VSCode 的 Git 扩展偶尔对这类状态的刷新有延迟命令行补一下更稳妥。合并冲突处理当 merge 或 pull 发生冲突时VSCode 会用红绿颜色标记冲突区域并提供 Accept Current Change、Accept Incoming Change、Accept Both Changes 按钮点一下就能解决冲突。对于复杂冲突我习惯配合 GitLens 插件看每一行代码的提交历史搞清楚哪些变更是我改的、哪些是别人加的再决定怎么合并。GitLens 是 Git 体验的超级增强它的 blame代码责任标注、历史浏览、分支对比功能都做得非常好值得一装。6. 从编辑器到开发环境代码补全、调试器与集成终端的正确使用这一节解决几个高频搜索问题运行时报错乱码、函数参数查看、调试器、跳转到定义、代码提示失效等。这些问题在配置不当的 VSCode 上几乎人人都会遇到一次。代码提示为什么有时候完全不工作代码提示IntelliSense不是凭空生成的它依赖语言服务。不同语言的提示机制有差别Python 靠 Pylance需要选对解释器。如果提示不工作先检查右下角解释器路径。C/C 靠 C/C 扩展里的 IntelliSense 引擎需要配置includePath尤其是你引用了第三方库时要显式添加到c_cpp_properties.json。Java 靠 Eclipse JDT Language Server项目构建文件pom.xml 或 build.gradle变了它需要重新加载遇到提示异常先在命令面板执行 Java: Clean Java Language Server Workspace。跳转到定义F12与返回把鼠标放在函数或变量上按F12就能跳到定义处Ctrl Alt -返回上一个位置如果你用的是 Visual Studio 习惯的Ctrl -也可以看键位设置。很多新手反馈vscode无法跳转到定义除了上面说的语言服务没有正常工作之外还有一种情况是文件在远程会话里扩展没有装到远程端导致语言服务没起来。所以排查思路就是一看扩展装没有装、二看语言服务状态、三看选没选对解释器/编译器。调试器使用F5 启动调试是最常用的。但不少人不知道断点是可以加条件的在断点上右键Edit Breakpoint输入条件表达式比如i 10这样只在满足条件时中断。变量监视面板可以动态添加你想跟踪的表达式。对 Python 来说调试时还能看到每一步的调用栈、局部变量、全局变量非常直观。C/C 调试时如果符号加载有问题检查 launch.json 里stopAtEntry: true是否打开以及编译时是否加了-g调试选项。乱码问题VSCode 里最常见的乱码场景是 Windows 上运行 Java 或 Python 程序控制台输出中文变成???或者鏄?之类的。原因要么是文件编码不是 UTF-8要么是终端代码页不对。文件编码可以在右下角状态栏看到和修改点一下选 Reopen with Encoding。终端代码页问题可以用chcp 65001临时切换或者在系统设置里勾选Beta: 使用 Unicode UTF-8 提供全球语言支持。排错时先分清是编译错误、代码问题还是显示问题别一上来就网上搜vscode乱码先把编码统一到 UTF-8 再说话。集成终端Ctrl 打开集成终端不用再切到外面开 CMD。默认是 PowerShellWindows你可以点终端标签栏右侧的下拉箭头选择默认 Shell也可以添加 Git Bash 或其他终端。集成终端和编辑器共用快捷键复制粘贴习惯、路径切换、多终端并行都方便。我用 VSCode 有一半时间在集成终端里跑命令切出去开终端的次数几乎为零。7. AI 编程助手接入Codex、Claude Code、DeepSeek 与相关插件的实战配置AI 编程是当前 VSCode 生态里最热的话题相关热词也是满天飞接入 DeepSeek、配置 Codex、装 Claude Code 插件、Trae 插件 Chat/Build 模式等等。这些工具本质上都是在编辑器里给你加一个 AI 对话/补全/自动改代码的能力。这里不讨论谁强谁弱只讲落地配置和常见坑。Codex 插件如果你用的是 OpenAI Codex CLI 或相关插件配置的核心是 API Key 和终端能力授权。安装好 Codex 插件后命令面板应该有 Codex: Sign in 或设置项让你填 API Key。很多人的困惑是为啥 vscode 里的 Codex 无法编辑代码。这个问题多半是权限设置问题Codex 这类工具要修改文件时会请求编辑权限你要在对应会话面板里确认授权还有一个可能就是你打开的文件夹路径包含中文或空格导致 Codex 的文件读写逻辑出错。把项目放到纯英文路径下大概率能解决。Claude Code 插件的安装Claude Code 不是官方 IDE 内建功能而是可以通过 npm 安装的 CLI 工具然后再通过 VSCode 插件如 Claude Code 或第三方封装接进来。基本步骤是确认本机装了 Node.js 18。在终端跑npm install -g anthropic-ai/claude-code。安装对应 VSCode 扩展登录 Anthropic 账号或配置 API Key。在 VSCode 里用命令面板启动 Claude 会话开始对话、让它读写代码。装之前确认网络环境能否访问相应服务。卡在这一步的人不在少数但这属于环境问题不在编辑器配置范畴内。DeepSeek 接入DeepSeek 提供了 OpenAI 兼容的 API很多 VSCode 的 AI 插件如 Continue、Cline、Codex 改 Base URL 场景都能直接配置成 DeepSeek 模型。以 Continue 插件为例在配置里添加一个 OpenAI 兼容 provider填上API Base URL:https://api.deepseek.com/v1API Key: 你的 DeepSeek KeyModel:deepseek-chat或deepseek-coder然后就能在侧边栏跟模型对话。注意一点DeepSeek 的模型上下文窗口有限遇到回答变短、丢上下文时开个新会话往往更靠谱。接入 DeepSeek 这种国产模型的好处是延迟低、费用低适合高频日常辅助。Trae 插件Chat 模式和 Build 模式Trae 插件是字节跳动出的 AI IDE/插件现在可以装在 VSCode 里。它的 Chat 模式类似普通 AI 对话可以解释代码、提问题Build 模式更激进你把需求描述给它它会直接生成多个文件、改动项目结构等于让 AI 当一个完整的开发执行者。装上之后在侧边栏选择模式Build 模式会请求文件写入权限跟 Codex 一样记得在设置里允许工作区编辑不然它光说不练。AI 辅助的定位最后说一句大实话AI 工具是放大器不是替代品。它能加速你写代码、改 bug、补测试但你得能看懂它生成的代码否则出了错你连问题在哪都不知道。我的建议是新手可以借助 AI 学习但每段生成代码都要读一遍理解它为什么这么写老手用它做重复劳动把精力留给架构和设计。8. 安卓开发与模拟器连接不靠 HBuilder用 VSCode 实现移动端调试VSCode 有没有插件可以直接连安卓模拟器不需要借助 HBuilder——这个热词说明很多人想在 VSCode 里做移动端开发调试。我用过的可行方案说几个。方案一ADB VSCode 终端安卓模拟器比如 MuMu、夜神、蓝叠启动后会监听一个 ADB 端口VSCode 里只要装 ADB Interface 插件或者直接在集成终端使用 ADB 命令就能随时查看设备列表、安装 APK、抓取日志。比如adb devices adb install app.apk adb logcat | grep your_tag很多前端项目比如 React Native、Flutter、uni-app 的 VSCode 工作流实际上都是靠 ADB 实现真机或模拟器调试的并不需要专门的 IDE。方案二Flutter 扩展如果做 Flutter 开发VSCode 的 Flutter 扩展自带模拟器管理和热重载启动模拟器后直接 F5 就能把应用跑起来。扩展会自动识别已启动的模拟器、连接 ADB、显示设备日志。这时候 VSCode 就是一个功能完整的移动端 IDE跟 Android Studio 比毫不逊色甚至切包更快。方案三前端项目的浏览器模拟如果是纯前端移动端项目比如 vant、uni-app 的 H5 模式在 VSCode 里装 Live Server 或通过 Vite 启动 Dev Server然后用模拟器里的浏览器打开地址也能实现所见即所得的效果。方案四Android WebView 调试如果你在写 Android 原生里的 WebView 混合应用VSCode 可以配合 Chrome DevTools 的远程调试做真机 WebView 调试。连接安卓设备并开启 USB 调试用 Chrome 的chrome://inspect找到 WebView 页面调试体验跟调试普通网页几乎一样。而 VSCode 插件园里也有工具可以直接抓取 logcat配合异常堆栈排查问题。踩坑提醒一个常见的坑是 ADB 版本冲突。电脑上装了 Android Studio、模拟器、其他工具链各自带了一份 ADB版本不一致会导致adb devices识别不到设备。解决办法是把模拟器目录下的 adb.exe 统一复制到系统 PATH 中或者使用一个固定版本的 adb 覆盖掉其他路径。另一个坑是模拟器启动后 VSCode 显示设备离线先执行adb kill-server adb start-server重启 ADB 服务大多数时候能解决。9. 多目录与多项目共存解决每次打开重新选择项目的困扰VSCode 每次打开重新选择项目——这个热词背后是很多人对工作区的理解还没建立起来。VSCode 默认打开一个文件夹就是一个项目但你同时维护多个项目时每次都从文件 - 打开文件夹进去确实很烦。方案一固定工作区把多个相关项目放进一个工作区文件 - 将文件夹添加到工作区然后文件 - 将工作区另存为得到一个.code-workspace文件。以后双击这个文件所有项目一起打开侧边栏会显示多根目录。适合前后端分离项目前端一个目录、后端一个目录、微服务多模块项目。方案二最近打开列表文件 - 最近打开快捷键Ctrl R能看到历史项目列表单击就能切换。这已经比每次找路径快得多。如果你还嫌慢可以装 Project Manager 插件用命令面板直接保存、切换项目比默认的最近打开更好用。方案三快捷键固定把常用项目固定到窗口在 Windows 资源管理器或者 Mac Finder 里拖拽文件夹到 VSCode 图标上或者用命令行code /path/to/project直接打开指定项目。把常用项目做成终端 alias一键打开alias myprojcode D:/work/MyProject窗口管理全屏开发者经常有十几个窗口同时开着。VSCode 的每个窗口对应一个项目或工作区Ctrl W关窗口时小心别把整个项目窗口关了。Ctrl Alt 左箭头/右箭头可以切换窗口Windows 的虚拟桌面切换Ctrl Tab在窗口内的文件间切换。这个问题的本质是建立项目入口意识。把你的项目根目录固定下来通过工作区或 Project Manager 管理之后的远程连接、调试配置、Git 仓库识别都会顺利很多。10. 隐藏但实用的进阶技巧汇总终端配置、中文插件、性能优化与常见报错最后一节我来把那些散落在各处、但实际很有用的技巧和坑集中说一遍。这些东西单看都不起眼组合起来却能显著提升体验。Ubuntu 下安装 VSCodeUbuntu 用户最省心的方式是用微软官方源wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor packages.microsoft.gpg sudo install -o root -g root -m 644 packages.microsoft.gpg /etc/apt/trusted.gpg.d/ echo deb [archamd64] https://packages.microsoft.com/repos/code stable main | sudo tee /etc/apt/sources.list.d/vscode.list sudo apt update sudo apt install code或者更简单从官网下载.deb包sudo dpkg -i安装。写系统级代码、配内核开发环境比如使用 mindspore 做 AI 训练读取内核文件时Ubuntu 上的 VSCode Remote-SSH 组合非常顺。Markdown 快捷键与自动目录Markdown All in One 插件提供Ctrl Shift P里的 Markdown All in One: Create Table of Contents一键生成 TOC 并自动更新。这对长文档非常有用。备份与恢复配置配置文件核心位置用户设置settings.json快捷键keybindings.json扩展列表通过命令面板 Extensions: Show Installed Extensions 导出或者在设置里开启同步。我个人的习惯是每个季度导出一次配置和扩展列表存到自己的配置仓库里。换电脑时一条命令同步下来所有插件、快捷键、主题全部恢复十分钟进入工作状态。不用 mermaid 画图虽然是编辑器功能但很多人热衷在 md 里画流程图这里提一嘴VSCode 插件里有支持各种图形的但团队协作时这类图在不同平台渲染不一致慎用。核心文档还是文字表格最稳妥。性能优化与常见卡顿禁用不常用扩展扩展不会拖慢启动的都少但某些重型扩展如 Live Share、某些 AI 插件会占用 CPU。可以在扩展面板中禁用工作区不需要的。搜索排除目录在设置里设置search.exclude把 node_modules、dist、build 等大目录排除掉搜索和全局跳转会快很多。文件监视排除把 node_modules 加入files.watcherExclude避免 VSCode 频繁监听文件改动导致 CPU 高企。找 .vscode 文件夹每个项目根目录都可以有.vscode文件夹存放该项目专属的 settings.json、launch.json、tasks.json。团队协作时把这个文件夹提交到 Git所有人打开项目都用同一套配置非常有利于统一环境。每次打开重新选择项目的进阶解法除了上面讲的 Project Manager还有一种情况是你安装了多个 VSCode 版本Stable 和 Insiders默认文件关联和打开方式打架。这种情况建议只留一个版本作为默认右键 .cs/.py 文件时明确选择用哪个打开。排查编码、路径与中文问题顺便说说为什么那么多问题跟中文有关。很多老外写工具时没有认真测过中文路径VSCode 虽然支持 UTF-8但有些扩展和编译工具并不一定支持。凡是遇到诡异难缠的 bug先把项目路径、用户名、临时目录里的中文全部换掉至少能排掉 30% 的坑。这不是歧视这是工具成熟度的现实。写在最后说实话VSCode 这玩意儿厉害的地方不是某个单一功能有多炫而是它把编辑、调试、终端、Git、远程开发、AI 辅助这些原本分散的能力全部整合到一个界面里并且通过插件生态让每个人都能把它调教成最适合自己的形态。很多人用不好不是因为软件不行而是没人告诉他们原来还能这样。最后再分享一点个人体会别追求完美的配置。我见过有人花了整整一天调主题、装插件、配快捷键代码一行没写。趁手的工具是慢慢长出来的遇到一个痛点解决一个时间长了它自然就成了你最顺手的开发环境。希望这篇能帮你少走一些弯路把省下来的时间留给真正重要的事——写代码解决问题做出东西来。