在开发markdow编辑器的时候，遇到了下面的问题。
欢迎体验：mdto 格式转换器 文章排版
问题背景
在 Linux 服务器上配置 Node.js 环境时，执行如下命令：
npm config set registry https://registry.npmmirror.com/终端却出现了这样一段 warning：
npm warn Unknown global config "--init.module". This will stop working in the next major version of npm. See `npm help npmrc` for supported config options.继续查看当前 npm 全局配置时，又会看到类似内容：
prefix=/www/server/nodejs/v22.19.0/
registry=https://registry.npmmirror.com/
cache=/www/server/nodejs/cache/
--init.module=/www/server/nodejs/v22.19.0/etc/init-module.js很多人第一次看到这个 warning，会误以为是 registry 设置失败、npm 损坏，或者 Node.js 版本不兼容。
实际上，这个问题与 registry 本身无关，而是 npm 配置文件中存在一个已经废弃的旧配置项。
问题原因
报错中的关键内容是：
--init.module这是旧版本 npm 中使用过的一种配置写法。
在较新的 npm 版本中，配置项名称已经改为：
init-module也就是说：
错误写法：
--init.module=/path/to/init-module.js正确写法：
init-module=/path/to/init-module.js虽然当前版本 npm 仍然只是 warning，不会阻止命令执行，但在未来大版本升级后，这种旧配置很可能直接导致 npm 命令报错。
因此建议尽快修复。
如何定位问题配置
首先查看 npm 当前使用的全局配置文件路径：
npm config get globalconfig一般会输出类似：
/www/server/nodejs/v22.19.0/etc/npmrc然后查看该配置文件内容：
cat /www/server/nodejs/v22.19.0/etc/npmrc如果看到类似下面这一行：
--init.module=/www/server/nodejs/v22.19.0/etc/init-module.js那么问题已经确认。
解决方案
方案一：手动编辑 npmrc 文件
直接打开 npm 配置文件：
vi /www/server/nodejs/v22.19.0/etc/npmrc将：
--init.module=/www/server/nodejs/v22.19.0/etc/init-module.js修改为：
init-module=/www/server/nodejs/v22.19.0/etc/init-module.js保存退出即可。
方案二：使用 sed 一键替换
如果不想进入编辑器，可以直接使用 sed 命令替换：
sed -i 's/^--init\.module=/init-module=/' /www/server/nodejs/v22.19.0/etc/npmrc执行完成后，再次查看配置文件：
cat /www/server/nodejs/v22.19.0/etc/npmrc确认已经变成：
init-module=/www/server/nodejs/v22.19.0/etc/init-module.js验证是否修复成功
修改完成后，再次执行：
npm config set registry https://registry.npmmirror.com/如果 warning 不再出现，说明问题已经解决。
也可以通过下面命令再次检查 npm 配置：
npm config list确认不存在 --init.module 即可。
为什么会出现这种问题
这种问题通常出现在以下几类环境中：
-
老版本 Node.js 升级到新版本 npm 后，旧配置文件被保留。
-
宝塔、OpenCloudOS、Node 管理面板等自动安装环境，可能会写入过期配置。
-
旧教程或旧脚本仍然使用
--init.module写法。 -
从其他服务器迁移
.npmrc配置文件时，将历史遗留配置一起带了过来。
很多时候 npm 能正常使用，但每次执行命令都会出现 warning，时间久了容易忽略。
真正危险的是，在未来 npm 大版本升级后，这种 warning 有可能直接变成 error，导致项目部署、构建或 CI/CD 任务失败。
总结
npm warn Unknown global config "--init.module" 并不是 registry 设置失败，也不是 npm 损坏，而是 npm 配置文件中仍然保留了已经废弃的旧写法。
核心修复方法只有一句话：
将：
--init.module=xxx改成：
init-module=xxx修复后不仅 warning 会消失，也能避免未来 npm 升级带来的兼容性问题。
对于服务器环境、面板环境、长期运行的部署机器，建议定期检查 .npmrc、全局 npmrc、Node 安装目录中的配置文件，及时清理历史遗留项，避免后续出现更难排查的问题。