无法发布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
相关产品推荐
相关产品推荐

