绝对导入和模块路径别名

示例

绝对导入和别名

Next.js 内置支持 tsconfig.json 和 jsconfig.json 文件的 "paths" 和 "baseUrl" 选项。

这些选项允许您将项目目录别名为绝对路径，从而更容易导入模块。例如

// before
import { Button } from '../../../components/button'
 
// after
import { Button } from '@/components/button'

**注意**：create-next-app 将提示您配置这些选项。

绝对导入

baseUrl 配置选项允许您直接从项目的根目录导入。

此配置的一个示例

tsconfig.json 或 jsconfig.json

{
  "compilerOptions": {
    "baseUrl": "."
  }
}

components/button.tsx

export default function Button() {
  return <button>Click me</button>
}

app/page.tsx

import Button from 'components/button'
 
export default function HomePage() {
  return (
    <>
      <h1>Hello World</h1>
      <Button />
    </>
  )
}

模块别名

除了配置 baseUrl 路径外，您还可以使用 "paths" 选项为模块路径设置“别名”。

例如，以下配置将 @/components/* 映射到 components/*

tsconfig.json 或 jsconfig.json

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/components/*": ["components/*"]
    }
  }
}

components/button.tsx

export default function Button() {
  return <button>Click me</button>
}

app/page.tsx

import Button from '@/components/button'
 
export default function HomePage() {
  return (
    <>
      <h1>Hello World</h1>
      <Button />
    </>
  )
}

每个 "paths" 相对于 baseUrl 位置。例如

tsconfig.json 或 jsconfig.json

{
  "compilerOptions": {
    "baseUrl": "src/",
    "paths": {
      "@/styles/*": ["styles/*"],
      "@/components/*": ["components/*"]
    }
  }
}

app/page.tsx

import Button from '@/components/button'
import '@/styles/styles.css'
import Helper from 'utils/helper'
 
export default function HomePage() {
  return (
    <Helper>
      <h1>Hello World</h1>
      <Button />
    </Helper>
  )
}