Import Cost 插件需正确安装、Node.js 环境就绪、工作区启用、导入语句符合 ES 模块规范,并可手动刷新以显示 import 体积,如 ~4.2 kB。

如果您在使用 VSCode 编写 JavaScript 或 TypeScript 项目时,希望在编辑器中直接看到每个 import 语句所引入模块的体积大小,则可能是由于 Import Cost 插件未正确启用或配置。以下是启用并验证该插件功能的步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装 Import Cost 插件
Import Cost 是一个轻量级的 VSCode 扩展,它通过静态分析 import 语句,调用 esm-bundle 或其他打包器后端估算依赖体积,无需实际构建即可显示近似包大小。
1、打开 VSCode,点击左侧活动栏中的扩展图标(四个方块组成的图标)。
2、在扩展市场搜索框中输入 Import Cost。
3、在搜索结果中找到作者为 wix 的官方插件,点击“安装”按钮。
4、安装完成后,重启 VSCode 或重新加载窗口(Ctrl+Shift+P → 输入 Reload Window → 回车)。
二、确认 Node.js 环境可用
Import Cost 插件依赖本地 Node.js 运行时执行体积估算逻辑,若系统未安装 Node.js 或 PATH 未配置,插件将无法显示大小数值,仅显示“?”或空白。
1、打开终端,执行命令 node --version,确认输出类似 v18.19.0 的版本号。
2、若提示 command not found,需前往 https://nodejs.org 下载并安装 LTS 版本。
3、安装后关闭并重新打开终端,再次运行 node --version 验证。
三、检查工作区是否启用插件
VSCode 支持按工作区禁用扩展,即使全局安装了 Import Cost,当前文件夹若被排除,插件也不会生效。
1、打开命令面板(Cmd+Shift+P),输入 Extensions: Show Enabled Extensions in This Workspace。
2、在列表中查找 Import Cost,确认其右侧开关处于开启状态。
3、如为关闭状态,点击开关启用;如未列出,执行 Extensions: Show Disabled Extensions in This Workspace 并启用。
四、验证 import 语句是否符合识别规则
Import Cost 仅对标准 ES 模块语法(import … from …)及部分 CommonJS require() 调用进行解析,不支持动态 import() 表达式、字符串拼接路径或非字面量导入源。
1、在 .js 或 .ts 文件中编写如下语句:import React from 'react';
2、保存文件后,观察 import 语句右侧是否出现灰色小字,如 ~4.2 kB。
3、若无显示,尝试替换为 import { useState } from 'react';,避免默认导出可能引发的解析延迟。
五、手动触发体积重载
当包体积未更新或缓存过期时,插件可能沿用旧估值,此时可强制刷新当前文件的 import 成本计算。
1、将光标置于任意 import 行上。
2、按下 Cmd+Shift+P 打开命令面板。
3、输入 Import Cost: Refresh current file 并回车。
4、等待右下角状态栏短暂显示 “Import Cost refreshed” 提示。










