如何在vue项目中配置引用路径“@”

  • 配置引用路径(以“@”引用为项目的src目录为例)可拆分为如下两步操作
    • 配置webpack打包时将“@”解析为项目的src目录
    • 配置vsCode在路径中输入“@”时的路径提示
  • 本贴着重讲解“配置webpack打包时将‘@’解析为项目的src目录”的操作和溯源
    • 操作
      • 在项目根目录的vue.config.js文件中做如下配置
        const path = require('path')
        module.exports = {
          configureWebpack: {
            resolve: {
              alias: {
                '@': path.resolve(__dirname, 'src')
              }
            }
          }
        }
        
      • 说明:如果没有这段配置但引用路径“@”依然生效,则是环境内置了这段配置。

    • 溯源

      • 来到Vue CLI官网(webpack 相关 | Vue CLI),我们可以找到如何通过“简单的方式”配置webpack的说明。

      •  继而来到webpack官网(解析(Resolve) | webpack 中文文档),在resolve配置项中alias关键字的配置中,找到了关于“创建importrequire的别名”的配置的说明。 

      •  综合以上两处文档,可以溯源“配置webpack打包时将‘@’解析为项目的src目录”的语法出处。

  • 关于如何“配置vsCode在路径中输入‘@’时的路径提示”

  • 特别提醒:在样式中使用引用路径时,前面需要加“~”

    • 示例代码

      <style lang="less" scoped>
      @import "~@/styles/variables.less";
      .test {
          background: url('~@/assets/images/logo.png')
      }
      </style>
    • 溯源

Vue 3项目配置中,使用路径别名(alias)是为了简化路径引用,特别是在大型项目中避免硬编码相对或绝对路径。如果你遇到中文路径别名报错,可能是由于以下原因: 1. **字符编码问题**:确保你的`vue.config.js`文件以及包含路径别名的文件使用的是UTF-8无BOM编码,因为非UTF-8可能会导致中文路径解析错误。 ```javascript module.exports = { chainWebpack: config => { config.resolve.alias.set( // 使用反斜杠(\)而不是正斜杠(/)表示路径 '@assets': resolve('src/assets'), '@components': resolve('src/components'), '@views': resolve('src/views') ); }, }; ``` 确保`resolve()`函数内的字符串使用正确的转义字符。 2. **路径映射配置错误**:检查路径别名是否正确指向了实际的目录,例如路径别名是否指到了源码中的某个中文命名文件夹。 3. **Webpack版本兼容**:Vue CLI 3.x 和 Vue 3 项目的默认配置对webpack别名的处理有所不同,确保使用的Vue CLI版本支持中文路径别名功能。 4. **ES模块和CommonJS冲突**:如果既有`.js`又有`.ts`文件,需要确保你的构建配置正确地处理了模块导入,可能需要设置`esModuleInterop`和`resolve.symlinks`选项。 5. **Node环境问题**:在某些运行环境中,如Windows,文件路径可能需要额外处理,你可以试试`path.posix`模块来进行规范化。 解决完上述问题后,通常可以尝试重启开发服务器或清除浏览器缓存再查看效果。如果问题依然存在,提供具体的错误信息会有助于更准确地定位问题。
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值