NPM packages not found

发表于 更新于

NPM packages not found

内容来源

NPM packages not found

NPM packages not found. Please confirm npm packages which need to build are belong to miniprogramRoot directory. Or you may edit project.config.json’s packNpmManually and packNpmRelationList
appid: wx429151859caeb046
openid: o6zAJsws4oaOjHasDK8qBirpUw8Q
ideVersion: 2.01.2510290
osType: win32-x64

开发者工具找不到需要构建的 npm 包。

微信web开发者工具：wechat_devtools_2.01.2510290_win32_x64.exe

IDE 版本（2.01.2510290），这套新版的配置方式确实需要特别注意。

🎯根本原因

project.config.json 中可能同时存在 miniprogramRoot 配置，而 packNpmRelationList 中的路径没有与之匹配，导致工具找不到 node_modules。

##✅ 解决方案（三步走）

第一步：确认项目结构

典型的微信小程序项目结构：

1
2
3
4
5
6
你的项目文件夹/
├── miniprogram/	← 小程序代码（app.json, pages/ 等）
├── node_modules/	← npm 包（安装后自动生成）
├── package.json
├── project.config.json
└── ...

如果 miniprogram/ 存在，说明 miniprogramRoot 已经指向了 miniprogram 文件夹。

第二步：修改 project.config.json（关键）

在 project.config.json 中，按以下方式配置，注意 miniprogramNpmDistDir 的值要根据你的实际 miniprogramRoot 来调整。

1
2
3
4
5
6
7
8
9
10
11
12
13
{
	// 假设你的代码在 miniprogram 文件夹
  \"miniprogramRoot\": \"miniprogram/\",   
  \"setting\": {
    \"packNpmManually\": true,
    \"packNpmRelationList\": [
      {
        \"packageJsonPath\": \"./package.json\",
        \"miniprogramNpmDistDir\": \"./miniprogram/\"
      }
    ]
  }
}

关键点说明：

字段 值 含义
miniprogramRoot "miniprogram/" 小程序代码文件夹
packageJsonPath "./package.json" package.json 在项目根目录
miniprogramNpmDistDir "./miniprogram/" 构建后的 miniprogram_npm 在 miniprogram/ 下面，小程序能引用
💡 如果你的小程序代码直接在根目录（没有 miniprogram/ 文件夹），那么 miniprogramRoot 应该是 "./"，miniprogramNpmDistDir 也设为 "./" 即可。

第三步：重新构建

保存 project.config.json 文件。

点击微信开发者工具菜单栏：工具 -> 构建 npm。

等待构建完成，项目根目录（或 miniprogram/ 下）会出现 miniprogram_npm 文件夹。

🔧 “杀手锏”

如果还是报错，试试这个“杀手锏”。

有些情况下，开发者工具缓存了旧配置，导致新配置不生效。可以这样做：

完全关闭微信开发者工具。

手动删除项目下的 miniprogram_npm 文件夹（如果有）。

重新打开开发者工具，先不要点击构建 npm。

先点击菜单栏 项目 -> 重新打开此项目，让工具重新加载所有配置。

然后再点击 工具 -> 构建 npm。

修改后的 project.config.json

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
{
  \"miniprogramRoot\": \"miniprogram/\",
  \"cloudfunctionRoot\": \"cloudfunctions/\",
  \"setting\": {
    \"urlCheck\": true,
    \"es6\": true,
    \"enhance\": true,
    \"postcss\": true,
    \"preloadBackgroundData\": false,
    \"minified\": true,
    \"newFeature\": true,
    \"coverView\": true,
    \"nodeModules\": false,
    \"autoAudits\": false,
    \"showShadowRootInWxmlPanel\": true,
    \"scopeDataCheck\": false,
    \"uglifyFileName\": false,
    \"checkInvalidKey\": true,
    \"checkSiteMap\": true,
    \"uploadWithSourceMap\": true,
    \"compileHotReLoad\": false,
    \"useMultiFrameRuntime\": true,
    \"useApiHook\": true,
    \"useApiHostProcess\": true,
    \"babelSetting\": {
      \"ignore\": [],
      \"disablePlugins\": [],
      \"outputPath\": \"\"
    },
    \"enableEngineNative\": false,
    \"useIsolateContext\": true,
    \"useCompilerModule\": true,
    \"userConfirmedUseCompilerModuleSwitch\": false,
    \"userConfirmedBundleSwitch\": false,
    \"packNpmManually\": true,
    \"packNpmRelationList\": [
      {
        \"packageJsonPath\": \"./package.json\",
        \"miniprogramNpmDistDir\": \"./miniprogram/\"
      }
    ],
    \"minifyWXSS\": true,
    \"compileWorklet\": false,
    \"minifyWXML\": true,
    \"localPlugins\": false,
    \"disableUseStrict\": false,
    \"useCompilerPlugins\": false,
    \"condition\": false,
    \"swc\": false,
    \"disableSWC\": true
  },
  \"appid\": \"wx429151859caeb046\",
  \"projectname\": \"quickstart-wx-cloud\",
  \"libVersion\": \"3.17.0\",
  \"cloudfunctionTemplateRoot\": \"cloudfunctionTemplate/\",
  \"condition\": {
    \"search\": {
      \"list\": []
    },
    \"conversation\": {
      \"list\": []
    },
    \"plugin\": {
      \"list\": []
    },
    \"game\": {
      \"list\": []
    },
    \"miniprogram\": {
      \"list\": [
        {
          \"id\": -1,
          \"name\": \"db guide\",
          \"pathName\": \"pages/databaseGuide/databaseGuide\"
        }
      ]
    }
  },
  \"compileType\": \"miniprogram\",
  \"srcMiniprogramRoot\": \"miniprogram/\",
  \"packOptions\": {
    \"ignore\": [],
    \"include\": []
  },
  \"editorSetting\": {
    \"tabIndent\": \"insertSpaces\",
    \"tabSize\": 2
  },
  \"simulatorPluginLibVersion\": {}
}