温馨提示：在 ChatGPT 官网（www.chatgpt.com）使用 GPT-5.5、ChatGPT-Image-2 等模型时，需要 ChatGPT Plus 或更高等级的会员权限。如需购买账号或充值会员，请扫码添加我们客服咨询。
Cursor IDE扩展开发学习路径：官方文档是首选，重点阅读Extensibility指南；YouTube上Search for“Cursor extension tutorial”可获取实操视频，推荐Follow“Code with Aiden”等创作者；GitHub搜索“cursor-extension-example”可直接参考开源项目，核心掌握TypeScript、VS Code Extension API（Cursor兼容）、React组件与WebView开发，建议从“Hello World”扩展起步，逐步实现命令注册、侧边栏面板和AI回调功能，官方社区Discord和Reddit的r/cursor板块是提问与分享的最佳渠道。
本文目录导读：
很多人刚开始用Cursor IDE的时候，会觉得它比VS Code好用，因为AI写代码确实快，但用着用着就会发现，有些活还是得靠自定义扩展来做，比如你想加个快捷键批量改代码，或者想要一个专门整理文件的小工具，这时候就得自己写扩展了。
那问题来了：Cursor IDE写扩展哪里学？ 这事其实没那么难，难点在于你找不到对的路，今天我帮你把这条路理清楚。
先搞懂Cursor IDE和VS Code的关系
谈到写扩展,你得先知道一个事：Cursor IDE本身就是基于VS Code改的，说白了，它用的是VS Code的底层结构、编辑器内核还有插件系统，你写的扩展，绝大多数情况可以直接在Cursor里用，写法也几乎一样。
这意味着什么？就是你根本不需要去学一套“专属于Cursor”的扩展开发教程，你只需要学VS Code的扩展开发就好，剩下的细节就是个配置问题。
好处是：资料多，网上随便搜“VS Code扩展开发”都有成千上万的帖子。 坏处是：资料杂，很多教程太老，或者只讲个光秃秃的例子，让人看了还是不会动手。
所以下面我会推荐一套精简但靠谱的学习路径,跟着走，最多花三天就能写出来一个能用的扩展。
学习Cursor扩展的核心步骤
搞清楚扩展长什么样
最简单的理解：扩展就是一个文件夹，里面放着几个必要的文件。
package.json—— 告诉编辑器你这个扩展叫什么、怎么触发、什么时候运行extension.js—— 真正的代码放这里- 可能还有一些图标文件、配置项定义
写扩展本质上就是写这些文件,然后用vsce这个工具打个包，再装进编辑器里。
你不需要什么高级的前端框架,你只需要会一点JavaScript，知道怎么监听事件、怎么调用编辑器API就行。
先看官方文档的“快速开始”
说实话,我不建议一上来就从头到尾去看VS Code的扩展API文档，那东西四百页，看完你也就累了，但你得看它的快速开始部分。
去搜“VS Code extension quickstart”，打开第一个结果，它会教你写一个最简单的“Hello World”扩展，你照着敲一遍，按F5跑起来，能看到编辑器里多了一个弹窗或命令，这事就算入门了。
这是最直接的方法,很多人跳过这一步直接去看视频教程，结果花了三个小时还没装上环境，其实官方文档这一步写得比谁都清楚。
学三样最常用的API
不是所有API你都得学,你刚开始只需要掌握这三个：
- vscode.commands.registerCommand —— 注册一个命令，比如用户按了快捷键之后执行一段代码
- vscode.window.showInformationMessage —— 弹个提示框
- vscode.workspace.getConfiguration —— 读取用户的设置项
这三个加起来,你就能写出大部分常用扩展了。
比如你想写一个扩展,让用户在选中某段代码后，按一个快捷键把代码里的函数名改成大驼峰写法，你就可以先用registerCommand绑定快捷键，然后在回调里用编辑器API获取当前选中的文本，处理完以后替换回去。
找一个简单但能用的项目去抄
这个是我觉得最重要的一步,你先别自己从头想功能，而是去GitHub搜“vscode extension example”，找那种代码量在500行以下的小扩展，下载到本地跑一遍，看它怎么写测试，怎么用API，怎么处理用户配置。
推荐两个：
- Word Count —— 显示文档字数，简单、完整，初学者看得懂
- Todo Tree —— 在侧边栏显示代码里的TODO注释，稍微复杂一点，但能学会侧边栏视图怎么弄
你把它们从下载到本地运行一遍,整个流程就清楚了。
使用Cursor帮你写扩展
很多人不知道：其实你完全可以用Cursor本身去写Cursor的扩展。
什么意思？你打开Cursor编辑器，创建一个新文件夹，让AI帮你生成一个扩展的架子，你可以这么说：
“请帮我创建一个VS Code扩展，它能在侧边栏里显示当前打开的文件夹中所有图片文件的列表，请包含完整的package.json和extension.js。”
这样AI会直接给你一个可以运行的扩展,你只要保存文件，安装依赖，按F5运行就能用，比你自己一行一行敲快得多。
这是个非常重要的技巧,你不需要什么深度学习的知识，你只需要学会向AI描述“我想要什么”，就能得到一段能跑的原型代码，剩下的就是修修补补。
推荐的资源清单
这些是我测试下来比较靠谱的资源,不坑人。
官方资源（必看）
- VS Code Extension API 官方文档 —— 只看前两章就够了，后面按需查
- VS Code Extension Samples —— GitHub上官方维护的示例代码仓库
yo code脚手架工具 —— 直接用它的模板生成项目，比自己写package.json快很多
学习路径推荐
- 微软官方的30分钟视频“VS Code Extension Development” —— YouTube上有，英文的，但语速慢，开中文字幕能看懂
- GitHub上找“vscode-extension-samples” —— 这是官方示例，挑一个最小的看起
- 自己的需求驱动 —— 这是最有效的方式，比如你想批量替换文件里的图片路径，你就去查怎么用
vscode.workspace.findFiles，查到了写出来，这个知识点就再也忘不了了
说实话,最怕的就是只看不写，你看再多教程，不动手，三天后还是不会。
常见坑和解决办法
坑一：不知道“激活事件”这个概念
很多新手写好代码,按F5发现不起作用，原因是扩展的激活时机没设对。
package.json里有个字段叫activationEvents，你得告诉编辑器：什么时候加载你的扩展？是打开文件时，还是用户按了快捷键，还是检测到特定类型的文件？不写这个，Cursor根本不知道什么时候去运行你的代码。
解决办法：最简单的就是设成，表示任何时候都激活，当然这样会有点浪费性能，但新手阶段无所谓。
坑二：不知道自己写的扩展怎么发布
这个其实不急,你刚开始给自己用，把扩展文件复制到.vscode/extensions目录下就行，或者直接在你开发窗口里按F5启动调试，这时候扩展也是生效的。
等你想分享给别人的时候再用vsce package打包成vsix文件。
坑三：以为扩展必须用TypeScript
很多人说写扩展只能用TypeScript,其实不是，纯JavaScript也能写，你刚开始要求不高，完全可以用js，以后需要类型提示了再换成ts。
一些实用的建议
从解决一个实际问题开始写
别去学“怎么开发一个完整的扩展框架”，没什么用，你先问自己：我在用Cursor写代码时，有没有什么重复动作？比如每次都要手动删除注释，或者批量改文件名？
就拿这个问题去写一个扩展,问题越小越好，等你解决了一个小问题，你就会想写第二个。
用AI当你的老师
你不是有Cursor和Claude或ChatGPT吗？直接把它们当老师。
遇到不会写的API,不要硬翻文档，直接在AI里输入： “我想在VS Code扩展里读取用户打开的文件夹路径，应该用哪个API？”
AI会直接告诉你写法和代码片段,你复制粘贴，再改吧改吧就能用，比自己去翻Find In Page快多了。
不急着一开始就学发布
别急着去琢磨怎么把扩展上传到插件市场,那是后面的事，前期你只需要在你自己的Cursor里跑起来就行。
你要是一直想着“我得写一个完美的扩展然后发布出去给大家用”，反而容易焦虑，一直不敢动笔。
看别人写的扩展源码
这个真的很有效,你去插件商店随便搜一个常见的扩展，Prettier”或者“ESLint”，看好之后去GitHub上找它的源码，不一定全看懂，就看它的extension.ts文件和package.json，你看别人怎么组织代码，怎么注册命令，怎么处理配置，这个收获比看十篇教程都多。
写在最后
回到最开始的问题：Cursor IDE写扩展哪里学？
答案是：你不用单独去学Cursor的扩展，你只需要学VS Code的扩展开发，信息渠道用官方文档、GitHub示例和AI问答这三个就够了。
别追求一开始就写大的扩展,你从一个小按钮、一个快捷键开始，能跑起来就算赢。
最关键的还是那句话：动手，你看完这篇之后，打开Cursor，新建一个文件夹，让AI给你生成一个最简单的扩展，按F5看它跑起来，你就已经比九成的人往前多走了一步。
剩下的就是遇到什么需求就查什么API,查到了就写，写多了自然就熟了。
祝你写扩展顺利。
温馨提示：在 ChatGPT 官网（www.chatgpt.com）使用 GPT-5.5、ChatGPT-Image-2 等模型时，需要 ChatGPT Plus 或更高等级的会员权限。如需购买账号或充值会员，请扫码添加我们客服咨询。
网友评论