title: 5 分钟上手｜从 0 发布你的第一个 npm 包（含掘金专属样式） category: 前端
> 全文 5 分钟读完，照着敲即可拥有 人生第一个 npm 包！
1. 创建包 · 一步到位
| 配置项 | 建议填写内容 | 备注 |
|---|---|---|
| package name | your-cool-utils | 全局唯一，先去 npm搜一下 |
| version | 1.0.0 | 语义化版本规范 |
| description | 一句话简介 | 将在 npm 搜索页展示 |
| entry point | index.js | 默认入口 |
| test command | 留空 | 可先跳过 |
| keywords | utils,helper,node | 提高曝光率 |
| author | your-name <邮箱> | 格式自由 |
| license | MIT | 宽松开源 |
# 1. 初始化
npm init
# 交互式填写，完成后生成 package.json
1.1 补充文档， professionalism ++
touch README.md
在 README.md 中至少写入：
包的内容简介
1.2 自定义启动脚本（可选）
打开 package.json，在 scripts 字段加一行：
"scripts": {
"start": "node index.js",
"test": "echo \"no test yet\""
}
之后本地一键运行：
npm start
2. 发布包 · 三步曲
2.1 检查 / 切换官方源
# 查看当前源
npm config get registry
# 确保是官方源
npm config set registry https://registry.npmjs.org
2.2 登录 npm 账号
npm login
# 依次输入 username、password、email
# 登录成功提示：Logged in as xxx on https://registry.npmjs.org/.
没有账号？先去 npm 官网 30s 注册。
2.3 一键发布
npm publish
3. 常见坑 · 速查表
| 问题 | 解决方式 |
|---|---|
| 403 Forbidden | 包名重复 / 账号未邮箱验证 |
| 401 Unauthorized | 登录过期，重新 npm login |
| 409 Conflict | 版本号已存在，改 version 再发 |
如果本文帮到了你，欢迎 ⬇️ 三连
点赞 + 收藏 + 评论，你们的鼓励是我持续输出的动力！
