@liuliang520500/jd-sdk

# 发布指南本文档将指导您如何将 jd-sdk 发布到 NPM。 ## 准备工作在发布之前，请确保： 1. 您已经拥有一个 NPM 账号 2. 您的 `package.json` 文件中的信息是正确的，特别是： - `name`：包名称 - `version`：包版本 - `description`：包描述 - `keywords`：关键词 - `author`：作者信息 - `license`：许可证 - `repository`：代码仓库信息 ## 发布步骤 ### 1. 登录 NPM ```bash npm login ``` 登录过程中需要输入用户名、密码和邮箱。如果配置了双因素认证，还需要输入认证码。 ### 2. 测试打包在发布前，最好先测试打包一下，检查包含了哪些文件： ```bash npm pack ``` 这将在当前目录下创建一个 `.tgz` 文件，但不会真正发布到 NPM。检查生成的 `.tgz` 文件内容是否符合预期： - 确认包含所有需要的源代码文件 - 确认没有包含不必要的文件（如 `node_modules`、`.env` 等） ### 3. 发布到 NPM 确认一切无误后，执行： ```bash npm publish ``` 如果要发布到特定的 NPM 注册表，可以使用： ```bash npm publish --registry=https://registry.npmjs.org ``` ### 4. 发布到私有注册表如果您想发布到私有注册表（如公司内部的 NPM 镜像），可以使用： ```bash npm publish --registry=https://your-private-registry.com ``` ### 5. 版本管理在后续更新时，需要先更新 `package.json` 中的版本号，推荐使用 npm 自带的版本管理命令： ```bash # 增加补丁版本 1.0.0 -> 1.0.1 npm version patch # 增加次要版本 1.0.0 -> 1.1.0 npm version minor # 增加主要版本 1.0.0 -> 2.0.0 npm version major ``` 然后再次发布： ```bash npm publish ``` ## 常见问题 ### 1. 发布时提示 403 错误可能原因： - 包名已被占用 - 没有登录或登录过期 - 没有发布权限 - 私有包但没有付费账户解决方案： - 修改包名，确保唯一性 - 重新登录 `npm login` - 确认账户权限 - 使用 `npm publish --access=public` 发布公共包 ### 2. 发布时提示 409 错误可能原因： - 尝试发布的版本已经存在解决方案： - 更新 `package.json` 中的版本号 - 使用 `npm version` 命令自动更新版本号 ### 3. 中国大陆用户提示网络问题可能原因： - 网络连接问题解决方案： - 使用淘宝镜像：`npm publish --registry=https://registry.npmmirror.com` - 使用代理服务器 - 使用 VPN ## 发布后的检查发布成功后，您可以检查包是否成功发布： ```bash npm view jd-sdk ``` 也可以在浏览器中访问： ``` https://www.npmjs.com/package/jd-sdk ``` ## 使用说明在其他项目中安装您发布的包： ```bash npm install jd-sdk --save ```