讲师中心 微信公众号
AI工具推荐 视频效率加速

TS 中的模块声明

大伟大大_6516

大伟大大_6516

发布时间:2024-11-16 08:03:06

|

1137人浏览过

|

来源于dev.to

转载

在这里我们学习如何编写高质量的 typescript 声明文件。因此,您正在使用 reactjs 进行编码并想要导入 svg 文件,但您的 ide/tsc 正在抱怨。

[ts] cannot find module './logo.svg'

现在是时候转向 stackoverflow 寻求快速复制粘贴解决方案了。

但是让我们坚持一下并尝试理解这些文件以及它们对我们的作用。

什么是模块?

在 ts/js 中,我们有很多方法来模块化用 ts/js 编写的应用程序。目前占据主导地位的是 esm(又名 es 模块、es6 模块)。我们通常通过它们的语法来了解它们:

TS 中的模块声明

因此,为了回答最初的问题,在符合 ecmascript 2015 的 ts/js 中,任何包含 顶级导入或导出的文件都被视为模块。

如果没有任何顶级导入或导出:

  1. 它们随处可见。
  2. 它们被视为脚本。

为什么使用模块?

不再有全局命名空间污染。这意味着:

  1. 模块在自己的作用域内执行。
  2. 我们需要明确导出我们想要导出的任何内容。
  3. 消费者可以从不同的模块导入他们向其他人公开的内容。

命名导出和默认导出

TS 中的模块声明

模块分辨率

在 ts 模块中,解析是从 import 或 require 语句中获取字符串,并确定该字符串引用哪个文件的过程。

在 ts 中我们有两种策略:

  1. 经典:
    • 默认的。
    • compileroptions.module 不是“commonjs”。
    • 包含在内是为了向后兼容。
  2. 节点:
    • 复制 nodejs 在 commonjs 模式下的工作方式。
    • 对 .ts 和 .d.ts 文件的额外检查。

顺便说一句,我们有很多地方可能会有意或无意地更改它(moduleresolution、baseurl、paths、rootdirs)。

Scrapfly SDK TypeScript
Scrapfly SDK TypeScript

使用 Scrapfly SDK(scrapfly-sdk)在 TypeScript 或 JavaScript 中进行网页抓取,用于用户请求抓取 URL、绕过反爬虫防护、渲染页面等场景。

下载

模块分辨率

  • 控制 ts 如何将模块说明符(导入/导出/require 语句中的字符串文字)解析为磁盘上的文件。
  • 应设置为匹配目标运行时或捆绑器使用的模块解析器。

例如,如果您正在构建应用程序以利用 esm(编译版本正在使用 esm),那么您需要在compileroptions.module 中选择“nodenext”。

TS 中的模块声明

  • 只要我们使用相对路径+文件扩展名 ts 就可以解析它(例如 import {} from "./a.js"; // ✅ 适用于每个 moduleresolution)。
  • 如果您计划编译应用程序以使用 esm,那么您需要指定文件的扩展名,并且不能无扩展名(例如 import {} from 'a.mjs';)。
  • 您还可以导入一个预计有index.ts文件的目录。

注意:如果在该目录中你有一个 package.json。然后 ts 使用它的 main 和 types 来获取它的类型。

在这里了解更多。

路径

所以基本上它会将导入重新映射到查找位置*s* 相对于 baseurl(如果设置),否则映射到 tsconfig 文件。最常见的用例是路径别名:

{
  "compilerOptions": {
    "module": "esnext",
    "moduleResolution": "bundler",
    "paths": {
      "@shared/*": ["./src/shared"]
    }
  }
}
注意 这对于运行时来说没有任何意义。这意味着您亲爱的捆绑器或编译器需要注意将它们正确地捆绑在一起。如果你的路径指向不存在的地方,那么你的应用程序在 nodejs 执行时将会崩溃。 提示 除此之外,您还可以利用 package.json 的导入(又名子路径导入)。

基本网址

  • 从中解析裸说明符的基目录1模块名称
  • 比从node_modules查找具有更高的优先级。
  • 使用路径时不再需要设置。

根目录

  • 许多“虚拟”目录充当单个根。
  • 然后编译器可以解析这些“虚拟”目录中的相对模块导入,就好像它们被合并到一个目录中一样。

编译后的js

要影响发出的 js 输出,我们可以修改:

  • 编译器选项.目标:
    • 确定将哪些 js 功能转换为在较旧的 javascript 运行时中运行。
    • 由我们的应用程序需求决定,比如我将在哪个浏览器/nodejs/electron 上运行这个编译的 ts 代码。
  • 编译器选项.模块:
    • 系统运行时将使用哪个模块。
    • 对现代 nodejs 项目使用“nodenext”。它读取最近的 package.json 文件并使用其“type”值来决定是否应该使用 commonjs 还是 esm。
    • 当您要将其与捆绑程序捆绑时,请使用“esnext”。

TS 中的模块声明

回到主题

所以我们想要导入 .graphql 文件或其他扩展名,ts 不知道它们是什么样的(它无法解析它们的类型)。现在 ts 知道导入的 svg、graphql 或其他文件会是什么样子。


参考。



  1. 裸说明符:导入语句中的模块名称,不是相对或绝对路径。这些通常是项目的 node_modules 或其他配置位置中的包的名称。 ↩

热门AI工具

更多
切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

相关专题

更多
TypeScript工程化开发与Vite构建优化实践
TypeScript工程化开发与Vite构建优化实践

本专题面向前端开发者,深入讲解 TypeScript 类型系统与大型项目结构设计方法,并结合 Vite 构建工具优化前端工程化流程。内容包括模块化设计、类型声明管理、代码分割、热更新原理以及构建性能调优。通过完整项目示例,帮助开发者提升代码可维护性与开发效率。

312

2026.02.13

TypeScript全栈项目架构与接口规范设计
TypeScript全栈项目架构与接口规范设计

本专题面向全栈开发者,系统讲解基于 TypeScript 构建前后端统一技术栈的工程化实践。内容涵盖项目分层设计、接口协议规范、类型共享机制、错误码体系设计、接口自动化生成与文档维护方案。通过完整项目示例,帮助开发者构建结构清晰、类型安全、易维护的现代全栈应用架构。

520

2026.02.25

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

391

2026.03.13

TypeScript 全栈开发进阶指南
TypeScript 全栈开发进阶指南

面向有 JavaScript 基础的开发者,深入讲解 TypeScript 的类型系统与全栈开发实践。

286

2026.06.03

TypeScript Node.js 全栈工程化与Monorepo架构实践
TypeScript Node.js 全栈工程化与Monorepo架构实践

本专题围绕 TypeScript 在 Node.js 全栈开发中的工程化实践展开,系统讲解 Monorepo 架构设计、包管理策略、模块复用机制以及服务端与前端统一类型系统的构建方法。通过真实项目案例,帮助开发者提升大型全栈项目的可维护性与协作效率。

658

2026.06.16

Python GraphQL API 开发实战
Python GraphQL API 开发实战

本专题系统讲解 Python 在 GraphQL API 开发中的实际应用,涵盖 GraphQL 基础概念、Schema 设计、Query 与 Mutation 实现、权限控制、分页与性能优化,以及与现有 REST 服务和数据库的整合方式。通过完整示例,帮助学习者掌握 使用 Python 构建高扩展性、前后端协作友好的 GraphQL 接口服务,适用于中大型应用与复杂数据查询场景。

229

2026.01.21

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2195

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3462

2023.08.23

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

20

2026.10.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
快速入门Node.JS全套完整版
快速入门Node.JS全套完整版

共83课时 | 13.5万人学习

nodejs开发基础教程
nodejs开发基础教程

共15课时 | 4.9万人学习

JavaScript设计模式视频教程
JavaScript设计模式视频教程

共28课时 | 6.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn