常见错误

本页详细介绍了几个常见的问题和错误信息。对于进一步的帮助，我们有一个活跃的GitHub讨论论坛和Discord。开发人员和社区贡献者经常在这两个论坛上回答问题。

No such file or directory

ENOENT: no such file or directory, open …/node_modules/csstype/index.js

这个错误信息有时会出现在旧版本的Snowpack中。

要解决这个问题。升级到Snowpackv2.6.0或更高版本。如果你在较新版本的Snowpack中继续看到这个意外的错误，请提交一个issue。

Package exists but package.json “exports” does not include entry

Node.js最近增加了对package.json “exports” 条目的支持，该条目定义了哪些文件可以从一个包内import，哪些不能。例如，Preact定义了一个 “exports” map，允许你import “preact/hooks”，但不能import “preact/some/custom/file-path.js”。这使得包可以控制它们的 “public”接口。

如果你看到这个错误信息，这意味着你import了一个export map中不允许的文件路径。如果你认为这是一个错误，请与包的作者联系，要求将该文件添加到他们的export map中。

Uncaught SyntaxError: The requested module ‘./XXXXXX.js’ does not provide an export named ‘YYYYYY’

如果你使用的是TypeScript，如果你import或export的东西只存在于TypeScript中（比如一个type或interface），而实际上并不存在于最终的JavaScript代码中，就会出现这个错误。

我们内置的TypeScript支持可以检测到纯类型的import，并会尝试自动删除它们。然而，这对于纯类型的导出语句来说要困难得多，因为如果没有多个文件的上下文环境，Snowpack无法检测到被export的符号是一个类型。例如，像export { MyInterfaceName }这样的语句在Snowpack中不会生效。

要解决这个问题。在tsconfig.json中启用isolatedModules，以识别有问题的情况。使用import type { MyInterfaceName }和export type { MyInterfaceName }来帮助 Snowpack 忽略类型。

如果命名的import与旧的Common.js npm包一起使用，也会出现这个错误。由于我们的包扫描器的改进，对于大多数包来说不再是常见的问题。然而，有些包的编写或编译方式使得自动导入扫描无法进行。

要解决这个问题。对于不能被分析的传统Common.js/UMD包，使用默认的导入（import pkg from 'my-old-package'）。或者，在你的packageOptions.namedExports配置中添加包的名称，以便在运行时进行导入扫描。

// snowpack.config.mjs
export default {
  packageOptions: {
    namedExports: ['@shopify/polaris-tokens'],
  },
};

Installing Non-JS Packages

当从npm安装包时，你可能会遇到一些文件格式，只有在额外的解析/处理下才能运行。首先检查一下是否有针对该类型文件的Snowpack插件。

因为我们的内部安装程序是由Rollup驱动的，你也可以在你的Snowpack配置中添加Rollup插件来处理这些特殊的、罕见的文件。

  // snowpack.config.mjs
  export default {
+   rollup: {
+     plugins: [require('rollup-plugin-sass')()],
+   },
  };

更多信息请参考Rollup关于插件的文档。

RangeError: Invalid WebSocket frame: RSV1 must be clear

要解决这个问题。为开发服务器使用8080以外的任何其他端口。在Snowpack配置中指定端口即可实现。

  // snowpack.config.mjs
  export default {
+   devOptions: {
+     port: 3000,
+   },
  };

Package “[name]” not found. Have you installed it?

当Snowpack认为某些东西在node_modules中，但找不到它时，就会出现这个警告。这通常是因为你试图import一些没有前导词/、./、或./的东西。

下面是一些可能的解决方法。

我要从npm 中 import一个文件

如果你想import一个npm包，试着运行以下程序。

npm install [package].

然后重新运行Snowpack。如果问题仍然存在，可以尝试用alias告诉Snowpack在哪里可以找到它。

  // snowpack.config.mjs
  export default {
+   alias: {
+     myPackage: './path/to/myPackage',
+   },
  };

我要import一个本地的`.js`文件。

如果你在import一个本地文件时遇到这个错误，修复方法通常是这样的。

- import myFile from 'myFile.js';
+ import myFile from './myFile.js';

如果这个问题仍然存在，open a issue。

我要import一个本地的`.css`文件

对.css文件的修复与JS类似。在import路径前加一个./，。

- @import "myfile.css";
+ @import "./myfile.css";

虽然你可能习惯于在写CSS时不加./，而且浏览器也会支持它，但Snowpack的工作方式有些不同。因为我们允许你从npm无缝import，myfile.css将被解析为一个npm包，而/myfile.css、./myfile.css和../myfile.css将被解析为本地项目文件。

另外，./myfile.css是完全有效的，养成统一的习惯是很好的，可以防止模糊的解析。