vscode调试时npm publish报401，主因是终端未继承系统级认证凭据，需手动将~/.npmrc中的_authtoken复制到项目根目录.npmrc，并在launch.json中改用npm-cli.js路径或"run publish"方式触发生命周期钩子。
VSCode 调试时 npm publish 报 401 Unauthorized，不是 npm 配置错了，而是 VSCode 启动的终端没继承系统级认证凭据 —— 你得手动把 .npmrc 里的认证 token 注入到调试环境里。
VSCode 终端不读 ~/.npmrc 的认证信息
VSCode 默认启动的集成终端（哪怕你已用 npm login --registry http://localhost:4873/ 登录过）并不会自动加载全局 ~/.npmrc 中的 //localhost:4873/:_authToken 字段。它只认当前工作区根目录下的 .npmrc，且不会主动执行 npm login 的副作用（比如写 token 到用户级配置）。
- 现象：在 VSCode 终端里运行
npm publish失败，但同样命令在系统 Terminal 里能成功 - 原因：VSCode 终端启动时未 source shell profile，也未触发 npm 的 auth flow
- 验证方式：在 VSCode 终端里执行
npm config get //localhost:4873/:_authToken，返回空或 undefined - 解决办法：在项目根目录放一个
.npmrc，显式写入 token（从~/.npmrc复制粘贴那行），并确保该文件不被 .gitignore 忽略（内网环境可接受）
launch.json 中 npm publish 调试失败的常见陷阱
直接在 launch.json 里配置 "program": "npm", "args": ["publish"] 是错的 —— npm 不是可执行文件，它是 shell wrapper，VSCode 的 Node.js debug adapter 无法正确解析它的 shebang 和环境链。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 错误写法：
"program": "npm"→ 报spawn npm ENOENT - 正确做法：用
node调用 npm CLI 的内部入口，路径取决于你全局安装的 npm 版本："program": "/usr/local/node/lib/node_modules/npm/bin/npm-cli.js"（Linux/macOS）或"program": "C:\Program Files\nodejs\node_modules\npm\bin\npm-cli.js"（Windows） - 更稳妥的方式：改用
shell类型 launch，配合preLaunchTask执行发布前校验 - 必须加
"env": { "NODE_ENV": "production" }，否则某些包的prepublishOnly脚本可能跳过构建步骤
package.json scripts 中 publish 命令被 hook 拦截怎么办
很多包在 package.json 里写了 "prepublishOnly": "npm run build"，而 VSCode 调试时默认不执行这些 lifecycle hooks —— 它只跑你指定的 program，不会模拟完整 npm 执行上下文。
- 表现：
npm publish成功但上传的是未构建的源码，不是 dist 目录 - 根本原因：VSCode 的 debug 模式绕过了 npm 的 script runner，只调用了底层 publish 逻辑
- 临时解法：在
launch.json的"args"里改成["run", "publish"]，前提是你的scripts.publish已定义为完整流程 - 推荐做法：删掉
prepublishOnly，改用prepare（它在npm install和npm publish前都会触发，且 VSCode 调试时也能识别） - 注意：
prepare在内网环境下要确保构建依赖（如typescript、vite）已提前装好，不能依赖 postinstall 下载
真正卡住人的从来不是 Verdaccio 配置，而是 VSCode 调试器和 npm CLI 之间那层看不见的环境隔离 —— token 不透传、hook 不触发、路径不一致，三者叠加就足够让一次发包调试反复失败半小时。
