React项目引入getAddress autocomplete模块失败求助

数据老陈

2026-8-25

解决方案：Module not found: Can't resolve 'getaddresss-autocomplete'

首先注意到报错信息里的包名是getaddresss-autocomplete（多了一个s），而你安装的是getaddress-autocomplete，先排查拼写问题，再尝试以下方案：

检查包的实际文件结构与导出
进入node_modules/getaddress-autocomplete目录，查看package.json的main字段指向的文件是否存在。如果入口文件路径不正确，或者模块格式不兼容，可以直接导入具体的编译文件：
```
import getAddress from 'getaddress-autocomplete/dist/getaddress-autocomplete.min.js';
```
排查项目中的拼写错误
全局搜索项目代码，确认是否有其他地方误将包名写成getaddresss-autocomplete（多一个s），比如webpack配置、tsconfig.json、或者其他组件的导入语句，修正所有拼写错误。
清理缓存并重新安装
执行以下命令彻底清理缓存和依赖，重新安装：
```
npm cache clean --force
rm -rf node_modules package-lock.json
npm install
```
尝试CDN引入替代npm包
暂时绕过npm包的问题，在public/index.html中添加CDN脚本：
```
<script src="https://cdn.getaddress.io/scripts/getaddress-autocomplete-1.0.2.min.js"></script>
```
若使用TypeScript，在组件顶部添加全局变量声明：
```
declare var getAddress: any;
```
之后直接使用全局的getAddress对象即可。
检查模块解析配置
如果是自定义webpack配置，确保resolve.modules包含node_modules：
```
module.exports = {
  resolve: {
    modules: ['node_modules'],
  }
};
```
若使用Create React App，可通过craco或react-app-rewired修改resolve配置，确保包能被正确识别。