NPM与GitHub仓库文件差异成因、安全风险及防护方法咨询

一、为什么两者内容会独立存在？ #

• NPM包发布和GitHub仓库是完全独立的流程：开发者发布NPM包时，是把本地项目目录里的文件打包上传到NPM registry，和GitHub仓库没有自动同步机制。哪怕GitHub是空仓库，只要本地有文件，就能发布包含这些文件的包。
• 开发者主动选择不同内容：比如有些开发者把GitHub用作纯文档展示（只放README），实际代码仅发布到NPM；或是出于隐私、版权考虑，不把核心代码放到公开GitHub；还有可能是发布NPM包后，没把本地代码推送到GitHub（比如你提到的is-wds-ap，开发者写完代码发完NPM，只把README推了一次GitHub，其他文件根本没传）。

二、存在安全风险吗？ #

• 肯定有。信息差很容易被利用：比如GitHub上是无害的README，但NPM包的index.js可能藏着窃取数据、挖矿或执行恶意指令的代码。
• 这也是供应链攻击的常见手段：攻击者创建看似正规的GitHub仓库，却发布恶意NPM包，诱导用户安装。

三、is-wds-ap的内容差异怎么实现的？ #

• 流程很直白：开发者本地创建了包含README.md、index.js、package.json的项目，执行npm publish把这些文件上传到了NPM。
• 之后他只把README.md初始化并推送到GitHub，没传另外两个文件——所以GitHub只有README，NPM有完整包。因为两者同步全靠开发者手动操作，没有强制绑定，就出现了这种差异。
• 你说仓库只有一次提交，那就是这次提交只包含README，其他文件从来没被推到GitHub过，不是删除后没同步。

四、两者内容可能几乎完全不同吗？ #

• 完全可以。开发者能在本地随便写代码发NPM，GitHub仓库里放完全不相关的内容（比如假示例、纯文档，甚至空仓库）。极端情况是NPM包是恶意软件，GitHub却是看起来正规的开源项目，这种情况在真实的供应链攻击中已经出现过。

五、除了NPM Beta版"code"标签，还有哪些防护方法？ #

• 安装前用npm view <package-name> files命令查看NPM包的实际文件列表，和GitHub内容对比。
• 用npm pack <package-name>下载包的压缩包到本地，解压后检查所有文件内容，确认没问题再安装。
• 用第三方安全工具：比如Snyk、Dependabot，它们会扫描NPM包内容，检测恶意代码或漏洞，同时对比GitHub和NPM的内容一致性。
• 优先选有明确GitHub绑定、且仓库和NPM包内容同步的包；对GitHub内容缺失或不一致的包保持警惕，尽量不用。
• 搭建私有NPM registry，只允许经过审核的包进入，从源头降低风险。

内容的提问来源于stack exchange，提问作者DougC