You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

无法发布VS Code扩展:已编辑README.md仍报对应错误求助

解决VSCE发布时"未编辑README.md"的报错问题

我之前也踩过这个一模一样的坑!明明已经认认真真写完了README.md,结果执行vsce publish或者vsce package时还是弹出那个烦人的错误:

Error: Make sure to edit the README.md file before you publish your extension

给你几个实际有效的排查方向,按顺序试试:

  • 确认README的位置和文件名正确性:一定要保证文件在扩展的根目录下,并且文件名是严格的README.md(注意大小写!比如写成readme.md或者Readme.md,在部分系统里vsce会识别不到)。
  • 检查package.json的readme字段配置:打开你的package.json,看看有没有"readme"这个字段。如果有,要确认它的路径完全指向你的README文件(比如根目录的话就是"readme": "README.md");如果没有这个字段,vsce会默认找根目录的README.md,这时候只要文件存在就没问题。
  • 验证README内容的完整性:有时候哪怕你写了内容,如果过于简短(比如只有一句话)或者格式严重错误,vsce可能会误判为未编辑。可以补充一些基础内容:比如扩展名称、核心功能、使用步骤、截图(如果有的话),确保内容是完整可用的。
  • 清理缓存并重新尝试:先删掉之前生成的.vsix文件,然后执行vsce package重新打包。如果还是不行,可以尝试删除node_modules和package-lock.json,重新运行npm install后再试一次,有时候依赖缓存会导致奇怪的问题。
  • 确认发布者令牌权限(兜底排查):虽然错误提示指向README,但如果上面的方法都没用,可以检查一下你的访问令牌是否拥有publish权限——不过这个概率比较低,毕竟如果权限不够,vsce会给出更明确的权限错误提示。

内容的提问来源于stack exchange,提问作者Mehdi

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.26 08:55:49