You need to enable JavaScript to run this app. NuxtJS应用中如何在组件内使用package.json配置的版本号
优惠活动
大模型
产品
解决方案
定价
更多

NuxtJS应用中如何在组件内使用package.json配置的版本号

完全可以实现,无需额外依赖

不需要引入第三方工具或编写复杂的构建插件,依托Nuxt原生的运行时配置能力,就能安全、低冗余地把package.json中定义的版本号传递到前端组件中使用。

分版本实现方法

Nuxt2 场景

  • 第一步:在项目根目录的nuxt.config.js顶部直接引入package.json,这个配置文件本身运行在Node环境,读取本地文件没有任何限制。
    引入语句示例:import pkg from './package.json'
  • 第二步:把版本号写入publicRuntimeConfig配置块,这个块里定义的字段会被Nuxt自动暴露给所有前后端可访问的上下文。
    配置示例:
    export default {
      // 其他原有配置...
      publicRuntimeConfig: {
        appVersion: pkg.version
      }
    }
    
  • 第三步:在组件中读取值使用:
    Options API写法直接通过$config全局对象获取:
    <template>
      <div>当前应用版本:v{{ $config.appVersion }}</div>
    </template>
    
    使用Composition API的场景,通过组合式API上下文获取即可:
    import { useContext } from '@nuxtjs/composition-api'
    const { $config } = useContext()
    const currentVersion = computed(() => $config.appVersion)
    

Nuxt3 场景

实现逻辑和Nuxt2基本一致,仅配置路径和API写法有小幅调整:

  • 第一步:同样在根目录nuxt.config.ts顶部引入package.json:import pkg from './package.json'
  • 第二步:将版本号写入runtimeConfig.public公共配置块:
    export default defineNuxtConfig({
      // 其他原有配置...
      runtimeConfig: {
        public: {
          appVersion: pkg.version
        }
      }
    })
    
  • 第三步:组件中通过Nuxt内置的useRuntimeConfig组合式函数读取值:
    <script setup>
    const runtimeConfig = useRuntimeConfig()
    </script>
    <template>
      <div>当前应用版本:v{{ runtimeConfig.public.appVersion }}</div>
    </template>
    

避坑提示
不要图省事直接在Vue组件里写import pkg from '../../package.json':

  1. 这种写法会让打包工具把整个package.json的所有内容(包括依赖列表、脚本命令、甚至你不小心写在里面的本地敏感值)全部打进前端可访问的产物中,既增大了包体积,还可能造成敏感信息泄露。
  2. 通过Nuxt运行时配置注入的方式,只会把你明确暴露的appVersion字段传递给客户端,不会携带任何多余内容,安全性和包体积都更有保障。

内容的提问来源于stack exchange,提问作者Fernando

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.18 11:15:00