VSCode

解决VSCode配置、调试、性能及扩展冲突等疑难杂症

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:VSCode。
它的用途是:解决VSCode配置、调试、性能及扩展冲突等疑难杂症
完整的 Skill 内容见:https://321skill.com/skills/vscode-x-7/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“我的VSCode保存TypeScript文件时,Prettier没有自动格式化,但手动运行格式化命令是好的。” 它会引导你检查`editor.defaultFormatter`设置、工作区特定的`settings.json`、以及是否有其他扩展(如ESLint)的`formatOnSave`设置覆盖了全局行为。或者

对AI说:“在VSCode里按F5启动Node.js调试,但控制台没有任何输出,程序也没启动。” 它会帮你检查`launch.json`中的`program`路径是否正确、`preLaunchTask`是否配置错误导致阻塞,并指导你查看调试控制台输出以获取更详细的错误信息。

介绍

本Skill专门用于解决Visual Studio Code(VSCode)在日常开发中遇到的各类配置、调试和性能问题。当你的设置不生效、格式化工具冲突、断点无法命中、调试器无法启动、扩展崩溃或相互干扰、IntelliSense失效、远程开发连接异常、编辑器启动或搜索缓慢时,它可以提供清晰的排查思路和解决方案。

Skill通过分析VSCode的配置层级(如用户、工作区、文件夹设置)、调试配置文件(launch.json, tasks.json)、扩展管理、键盘快捷键绑定以及远程开发组件(如Remote-SSH, WSL, Dev Containers)的工作原理,帮助你定位问题的根源。例如,它会指导你检查哪个设置项被更高优先级的配置覆盖,或者如何解决两个格式化扩展的冲突。

它非常适合那些深度依赖VSCode进行开发,但经常被其复杂配置和偶发问题困扰的开发者。无论是前端、后端还是全栈工程师,只要使用VSCode作为主力编辑器,都能从中受益。对于团队而言,它也有助于统一.vscode文件夹下的配置,并明确哪些扩展适用于VSCodium或Cursor等衍生版本。

使用本Skill时,建议先明确问题现象,例如“保存时格式化了错误的语言”或“F5启动调试无反应”。Skill会引导你一步步排查。请注意,它不负责解决编程语言本身的语义问题(如TypeScript类型错误)、Docker镜像构建或通用的软件调试,这些问题应使用对应的专用Skill。

核心特点

专注于VSCode编辑器本身的配置、调试流程和扩展生态的疑难杂症排查,而非编程语言或通用调试。它能深入解析VSCode特有的多层级设置、扩展主机崩溃、格式化器冲突等编辑器内部机制问题。

注意事项

不适合解决编程语言语义问题(如TypeScript类型错误、Python语法)、Docker镜像构建或通用的软件Bug隔离。

常见问题

VSCode保存时自动格式化总是用错工具怎么办?

检查并配置正确的默认格式化程序,排查扩展冲突和设置作用域优先级。

VSCode调试时断点空心,无法命中怎么办?

检查launch.json配置是否正确,源映射(sourcemap)是否匹配,或尝试重新加载窗口。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/vscode-x-7/raw/index.md 读取 VSCode 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。