最直接有效的办法是临时禁用 npm 的 SSL 验证，命令为 npm config set strict-ssl false，该设置写入用户级 .npmrc，仅对 npm 生效且可快速验证是否为证书校验问题。
Node.js 在 VSCode 里装包失败，报错 unable to verify the first certificate 或 self signed certificate in certificate chain，根本原因不是 VSCode 的问题，而是 npm（或 Node）默认信任系统 CA 证书库，而你的公司代理、内网镜像或本地开发服务用了自签名证书，它不在这个信任链里。
npm install 报 SSL 证书错误时该关哪个开关
最直接有效的办法是临时禁用 npm 的 SSL 验证，命令是：
npm config set strict-ssl false
注意这不是永久方案，仅用于快速验证是否为证书问题。执行后重试 npm install，如果成功，说明确实是证书校验拦住了。
- 该设置写入用户级
.npmrc（通常在~/.npmrc），不影响全局其他用户 - 只对 npm 生效，不影响
yarn或pnpn - 不要在 CI/CD 或生产构建机上长期开启，会绕过所有 HTTPS 安全检查
想保留 SSL 校验但让 npm 信任你的自签名证书
把你的根证书（比如 corp-ca.crt）加进 npm 的信任链里：
Zenlink - Node SDK for ZenHeart
下载
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
npm config set cafile "/path/to/corp-ca.crt"
或者，如果你有多个证书，可以合并成一个 PEM 文件再指定：
cat corp-ca.crt internal-pki.crt > combined-ca.pem npm config set cafile "$(pwd)/combined-ca.pem"
- 确保路径是绝对路径，Windows 上用正斜杠或双反斜杠，例如
C:/certs/corp-ca.crt - 文件必须是 PEM 格式（以
-----BEGIN CERTIFICATE-----开头），不能是 DER 或 PFX - 改完后运行
npm config list确认cafile已生效 - 某些企业环境还会要求设置
registry，比如npm config set registry https://nexus.corp/repository/npm/
VSCode 终端里 npm 不读全局 .npmrc 怎么办
VSCode 内置终端（Terminal）默认继承系统 shell 的环境，但有时会跳过用户 profile 加载，导致 .npmrc 未被读取。验证方式是执行：
npm config get prefix
如果返回的是 /usr/local（macOS/Linux）或 C:\Program Files\nodejs（Windows），说明它正在读全局配置而非用户配置。
- 手动指定用户配置路径：
NPM_CONFIG_USERCONFIG=~/.npmrc npm install - 在 VSCode 设置中启用 “Run in terminal” 模式：打开
settings.json，加一行"terminal.integrated.env.linux": {"NPM_CONFIG_USERCONFIG": "/home/yourname/.npmrc"}（Windows/macOS 对应调整路径） - 更稳妥的做法：在项目根目录放一个
.npmrc，内容为cafile=./certs/corp-ca.crt，这样无论在哪启动终端都优先读它
真正麻烦的不是加证书，而是证书更新后没人通知你——内部 CA 轮换、代理升级、镜像服务迁移都会导致原有 cafile 失效。建议把证书文件和 .npmrc 一起纳入团队文档，而不是靠个人记忆维护。
