vant-vtk

本地测试步骤

1. 构建组件库

npm run build
npm run build:lib

2. 创建 npm link（在组件库目录）

npm link

3. 在测试项目中链接组件库

cd test-demo
npm link vant-vtk
npm install

4. 运行测试项目

npm run dev

npm 包发布流程

1. 确认账号登录

首次发布会用到 npm 账号，未登录时先登录（需输入用户名、密码及邮箱验证码）：

npm login

查看当前登录的账号：

npm whoami

2. 更新版本号

在 package.json 中修改 version 字段（发布后不可覆盖同名版本，必须递增）。也可以使用命令自动更新：

# 补丁版本，如 1.0.11 -> 1.0.12
npm version patch

# 次版本，如 1.0.11 -> 1.1.0
npm version minor

# 主版本，如 1.0.11 -> 2.0.0
npm version major

3. 构建产物

发布前必须重新构建，确保 dist 为最新代码：

npm run build
npm run build:lib

4. 预检查发布内容

先本地打包并预览将被发布的文件列表，确认只包含 dist 与 types，避免把源码或测试文件发出去：

npm pack --dry-run

5. 发布

# 正式发布
npm publish

# 若是 scoped 包（如 @scope/vant-vtk），需指定公开访问
npm publish --access public

6. 验证发布结果

npm view vant-vtk version

或在项目页面查看：https://www.npmjs.com/package/vant-vtk

7. 发布后更新本地依赖（可选）

在测试项目中升级到最新版本：

cd test-demo
npm install vant-vtk@latest

常见问题

• 403 Forbidden / not authorized：未登录或账号无该包发布权限，先执行 npm login 并用 npm whoami 确认；scoped 包需加 --access public。
• 版本已存在（EPUBLISHCONFLICT）：同一版本号不能重复发布，执行 npm version patch 递增版本后重新发布。
• 镜像源问题：若使用了淘宝等镜像，发布需指向官方源，可临时执行 npm publish --registry https://registry.npmjs.org/。
• 发布内容缺失：确认 vite build 与 vite build:lib 均已执行成功，且 dist、types 未被 .npmignore 误排除。