Vite React 项目绝对路径配置

原文: https://www.qiulin-dev.top/articles/2655fcfe-6456-4a66-928a-4b8d20aeb8d2

在 Vite 项目中,配置绝对路径可以让我们在导入模块时不再依赖相对路径 .../.../,而是通过简洁的别名来引用项目中的模块。接下来我们将详细介绍如何在 Vite 和 React 项目中配置绝对路径,并结合 TypeScript 的配置。

1. 配置 vite.config.ts

Vite 默认支持通过 alias 来配置路径别名。我们需要在 vite.config.ts 中添加相关的别名配置。以下是示例:

ts 复制代码
// vite.config.ts
import { defineConfig } from 'vite'; 
import react from '@vitejs/plugin-react';
import { resolve } from 'path';

export default defineConfig({
  plugins: [react()],
  resolve: {
    alias: {
      '@': resolve(__dirname, 'src'), // 将 @ 指向 src 目录
    },
  },
});

这里,我们使用了 Node.jspath.resolve 方法将 @别名指向项目的 src 目录。配置完成后,我们就可以在项目中通过 @ 来引用 src 目录下的文件。

path报错, 需要安装 @types/node

shell 复制代码
npm install --save-dev @types/node

2. 配置 TypeScript 路径别名

为了让 TypeScript 也识别我们设置的别名,我们需要在 tsconfig.json 中同步配置。添加以下配置:

json 复制代码
// tsconfig.json
{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/*": ["src/*"]
    }
  }
}

baseUrl 指定了相对路径的根目录为项目的根目录,paths 则是配置别名的映射关系。

3. 示例用法

现在我们可以使用 @ 来代替 src 目录。例如,假设项目中有以下文件结构:

shell 复制代码
src
│   main.tsx
└───components
    │   Hello.tsx

main.tsx 中导入 Hello 组件时,可以这样编写:

ts 复制代码
// src/main.tsx
import React from 'react';
import ReactDOM from 'react-dom/client';
import App from './App';
import '@/components/Hello'; // 使用绝对路径别名

ReactDOM.createRoot(document.getElementById('root') as HTMLElement).render(
  <React.StrictMode>
    <App />
  </React.StrictMode>
);

4. 结论

通过在 Vite 和 TypeScript 中配置路径别名,我们可以简化模块的导入路径,使代码更易于维护。以上步骤适用于大多数 Vite + React + TypeScript 项目,按照该流程即可轻松实现绝对路径的配置。

相关推荐
敲敲敲敲暴你脑袋11 分钟前
用canvas绘制兰伯特投影地图
typescript·数据可视化·canvas
用户486789525339014 分钟前
Apache ECharts 雷达图详解
前端·javascript
Moment28 分钟前
2025 年,构建高质量 React 项目的技术栈参考 🤔🤔🤔
前端·javascript·react.js
浩男孩1 小时前
🍀简简单单使用 TS 封装个工具库【更新中 ✍】
前端·typescript
快起来别睡了1 小时前
深入浅出 Event Loop:前端工程师必须掌握的运行机制
前端·javascript
user297525876121 小时前
别再用关键字搜了!手搓一个Vite插件,为页面上的标签打上标记
前端·javascript·vite
典学长编程2 小时前
前端开发(HTML,CSS,VUE,JS)从入门到精通!第五天(jQuery函数库)
javascript·css·ajax·html·jquery
尝尝你的优乐美2 小时前
原来前端二进制数组有这么多门道
前端·javascript·面试
前端_yu小白2 小时前
Vue2实现docx,xlsx,pptx预览
开发语言·javascript·ecmascript
金金金__2 小时前
事件循环-原理篇
javascript·浏览器