本篇是《独立开发者的平台寄生》系列的第 5 篇,讲开发者工具渠道的发布与变现,不讲 VS Code 扩展 API 或 JetBrains 插件 SDK 的入门。扩展开发的基础可以看站内
typescript、nodejs与 IDE 相关专题;本篇只处理「怎么发布、怎么收钱、怎么维护信任」。
一、十万安装,零收入
这是为解释机制构造的假设案例,人物、引语、收入和耗时均为教学设定,不是对真实事件的调查记录。
一位开发者做了一个 VS Code 扩展:在编辑器里选中一段 JSON,自动推断 TypeScript 类型并生成接口。扩展上架一年,十万安装,评分 4.8。评论区经常有人说「这个帮我省了半天」。
他想收费,于是做了三件事:在 README 里加了一个「请我喝咖啡」的链接、在扩展启动时弹了一次「升级 Pro」的提示、在 Marketplace 页面写了「Pro 版 5 美元/月」。
结果:赞助收入每月不到 30 美元;弹出提示导致评分从 4.8 掉到 4.5;Pro 版因为没有支付入口,用户根本不知道去哪里买。
问题不在需求,也不在价格。问题在于:这个假设案例没有建立清楚的付款与激活路径,不能据此认定开发者工具天生不能收费。
二、开发者工具渠道的特殊性
对开发者工具先验证三个问题,而不是预设所有个人都不愿付费:
- 用户使用频率与节约时间是否可观察?
- 谁承担预算:个人、主管、采购还是平台?
- 源码、权限、遥测和支持材料能否满足目标用户的信任要求?
免费插件、付费许可证和配套服务都是可测试方案;是否成立需要目标客户的付款证据。
三、VS Code Marketplace:免费分发,付费在平台外
3.1 发布机制
VS Code 扩展使用 vsce 打包与发布。基本流程:
发布前先完成:创建 Marketplace publisher;在 package.json 填写 publisher/name/version/engines.vscode;准备 README、许可与所引用资源;按官方流程为该发布者配置认证。PAT 应限定 Marketplace 发布范围和有效期,不写入仓库。
# 前提:已有合法的扩展工程与本地可用的 @vscode/vsce
cd my-extension
vsce package
# 下列步骤会登录并写入远端;仅在确认 publisher 和发布版本后执行
vsce login YOUR_PUBLISHER
vsce publish
这里没有创建 publisher 或安装完整工具链;读者应从官方发布文档选择当前受支持的认证方式。先在隔离环境打包并安装 VSIX 验证,再发布。Marketplace publisher 不能简单等同于“建一个 Azure DevOps 组织”。
3.2 付费机制:没有内建交易
VS Code 官方文档对 pricing 字段的说明是:只允许 Free 或 Trial,默认 Free。官方文档没有提供「付费扩展交易」机制。
这意味着:
- 你不能在 Marketplace 上直接卖扩展。
- 你不能依赖 Marketplace 处理订阅、退款、发票。
- 你的
pricing: Trial只是一个标签,不是支付系统。
3.3 四种可行的变现路径
| 路径 | 怎么做 | 适合 |
|---|---|---|
| 赞助 | GitHub Sponsors、Open Collective、赞助商 | 开源工具、个人维护、社区口碑好 |
| 外部许可证 | 插件免费,Pro 功能通过官网购买 license key 解锁 | 功能边界清楚、企业用户多 |
| 配套 SaaS | 插件是入口,付费在云端服务(同步、分析、协作、AI) | 有持续成本、团队协作 |
| 企业支持 | 免费插件 + 付费培训、定制、SLA、私有部署 | 企业客户、定制需求多 |
一个常见组合是:插件免费 + 配套 SaaS 收费。插件负责获客和日常使用,SaaS 负责同步、团队管理、审计和 AI 能力。仍需核对商品描述、试用标签、数据与支付流程是否符合对应规则,并验证收入能否覆盖成本。
四、JetBrains Marketplace:平台可以收钱
JetBrains Marketplace 与 VS Code 不同:它支持付费插件。开发者可以设置价格、试用期、许可证,由平台处理收款与结算。
官方文档(快照 2026-10-22)说明:
- 支持发布付费插件。
- 自动上传应使用当前官方支持的认证方式,token 只保留所需权限。
- 从免费切换到付费,需要提前通知用户。
JetBrains 当前分成说明列出 15% 佣金;标准结算有币种、月末后支付和最低金额条件,具体协议或个别安排可能不同。以其分成页和实际开发者协议为依据,不沿用“无法查到比例”的旧备注。
4.1 付费插件要注意什么
- 试用期。 让用户在付费前完整体验核心功能,比只给截图更有效。
- 许可证与 IDE 版本。 付费插件要兼容多个 IDE 版本;版本跨度越大,测试成本越高。
- 价格锚点。 个人版、团队版、企业版的差异要清楚;不要让用户在选择上花太多时间。
- 退款与支持。 平台有退款政策,但用户仍会找你;准备好常见问题和支持入口。
五、两个渠道的对比
| 维度 | VS Code Marketplace | JetBrains Marketplace |
|---|---|---|
| 分发规模 | 大,覆盖 VS Code 用户 | 中,覆盖 JetBrains IDE 用户 |
| 发布成本 | 免费,vsce 发布 | 免费注册,插件上传 |
| 付费机制 | 无内建交易,pricing 仅 Free/Trial | 支持付费插件,平台代收 |
| 变现路径 | 赞助、外部许可证、配套 SaaS、企业支持 | 付费插件、试用、企业授权 |
| 技术栈 | TypeScript / Node / Webview | Java / Kotlin / IntelliJ Platform SDK |
| 审核重点 | 图标、链接、功能、遥测 | 兼容性、签名、插件大小、审核 |
| 维护成本 | 中,需跟进 VS Code API | 高,需跟进多 IDE 版本 |
选择建议:
- 如果你的用户主要是前端、Node、Python、Go 的 VS Code 用户,优先 VS Code;变现走「插件免费 + 配套 SaaS」或赞助。
- 如果你的用户主要是 Java、Kotlin、IntelliJ 生态,且愿意为 IDE 内功能付费,JetBrains 的付费插件机制更直接。
- 如果两边都有用户,先做一个主渠道,另一个作为备渠道;不要同时从零维护两套插件。
六、遥测、隐私与信任
开发者工具的用户对遥测非常敏感。一次「默认开启、没有说明」的遥测,可能带来大量差评和卸载。
6.1 最小遥测原则
- 默认关闭或明确 opt-in。 除非是产品运行必需,否则不要默认收集。
- 只收集聚合指标。 例如功能使用次数、错误类型、版本分布,不收集代码内容、文件路径、项目名称。
- 在 README 和插件设置里写清楚。 收集什么、为什么、保留多久、怎么关闭。
- 提供关闭开关。 即使默认开启,也要让用户能一键关闭。
- 不要把遥测数据卖给第三方。 这是信任底线。
6.2 VS Code 的遥测约定
VS Code 提供了 vscode.env.isTelemetryEnabled 等机制,扩展应尊重用户的全局遥测设置。不要绕过它自己发请求。
6.3 隐私政策
即使只收集聚合数据,也建议准备一份简短的隐私说明,放在 README 和插件页面。内容不需要很长,但要具体:
本扩展收集:功能使用次数、错误类型、扩展版本、VS Code 版本。
不收集:代码内容、文件路径、项目名称、个人信息。
用途:改进功能与排错。
保留:90 天。
关闭方式:设置中关闭遥测,或卸载扩展。
七、发布与兼容性
7.1 版本与兼容性
- 在
package.json的engines.vscode里写清楚最低版本;不要为了兼容旧版本而放弃新 API。 - 维护一个兼容性矩阵:VS Code 版本 × 操作系统 × 关键功能。
- 对 JetBrains,维护 IDE 版本 × 插件版本的兼容表。
- 大版本升级前,先在预发布渠道放一段时间。
7.2 发布检查清单
- README 写清楚功能、权限、遥测、支持入口。
-
package.json的pricing与实际情况一致(Free/Trial)。 - 图标不是 SVG,链接是 HTTPS。
- 激活事件尽量少,避免拖慢启动。
- 重计算放到语言服务器或外部进程,不阻塞扩展宿主。
- 遥测尊重用户设置,README 有说明。
- 版本号递增,CHANGELOG 写人话。
- 准备好回滚版本与已知问题列表。
7.3 发布节奏
开发者工具的更新不需要很频繁,但需要稳定:
- 每 2–4 周一个功能版本。
- 紧急修复随时发。
- 大版本前放预发布。
- 每次更新在 CHANGELOG 里写清楚「修了什么、影响谁、要不要迁移」。
八、四种常见错误
错误一:在插件里硬塞付费墙
VS Code Marketplace 没有内建交易,不等于禁止商业化功能;问题是缺少可理解的付费说明、购买和激活路径。把付费点放到官网、配套 SaaS 或企业合同里。
错误二:默认开启遥测
开发者会看网络请求。默认开启、没有说明的遥测,会被当成间谍软件。
错误三:忽略启动性能
扩展宿主是共享的。一个启动时扫描整个项目的扩展,会拖慢所有用户的编辑器,差评会来得很快。
错误四:同时维护两套插件
VS Code 和 JetBrains 的技术栈差异很大。先做一个主渠道,验证需求和付费意愿,再考虑第二个。
九、行动清单
- 确定主渠道:VS Code 还是 JetBrains。
- 确定变现路径:赞助、外部许可证、配套 SaaS、企业支持。
- 在 README 写清楚权限、遥测、数据流、支持入口。
- 检查
pricing字段与实际情况一致。 - 把重计算移出扩展宿主,测一次冷启动。
- 准备一份兼容性矩阵与回滚版本。
- 如果做付费,先跑通「官网付款 → license key → 插件激活」的闭环。
使用边界与实操验收
此文区分免费分发、Trial 标签与实际交易;没有声明所有插件用户的付费意愿或留存分布。遥测示例只有在代码和服务端均符合时才能发布。
发布验收样例:新配置安装 VSIX→首次激活无无关弹窗→全局禁用遥测后检查网络→过期测试许可证显示明确购买入口→完成测试支付与激活→记录产品/版本/IDE/操作系统。用该闭环比较赞助、许可证与配套服务,不把下载量当收入。
关键参考与核验范围
以下链接支持对应的机制或规则;本文的案例、成本和经营评分是说明方法的假设,不能当作平台统计或收益承诺。核验日期:2026-10-22。
- VS Code 发布扩展 :发布者、认证、打包和发布是不同步骤。
- JetBrains 分成与结算 :佣金及结算条件。
- JetBrains 付费插件 :付费插件与平台授权机制。
系列导航
- 上一篇:浏览器扩展变现:买断、订阅、LTD 与站外支付的许可证设计
- 下一篇:Obsidian、Raycast 与 Alfred:轻量效率工具的社区目录与更新节奏
- 回到目录:独立开发者的平台寄生
- 相关阅读:独立开发者生存指南(四):工程与技术策略 、SaaS 第一批客户怎么来
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。