basePath & assetPrefix 测试

配置信息

basePath: 未配置

assetPrefix: 未配置

当前页面路径: /base-path-test

📍 路由测试

Link 组件(自动处理 basePath)

→ 回到首页 (/)
→ Hooks 测试 (/hooks-test)

普通 a 标签(需手动添加 basePath)

→ 回到首页 (/) - ⚠️ 不会自动添加 basePath

🖼️ 图片测试

Next.js Image 组件

使用 public 目录下的图片

Next.js Logo

普通 img 标签

⚠️ 不会自动处理 basePath

Next.js Logo

🎨 CSS 背景图测试

内联样式 background-image

⚠️ 不会自动处理 basePath 和 assetPrefix

Tailwind CSS 背景图

⚠️ 不会自动处理 basePath 和 assetPrefix

📦 静态资源加载测试

✅ assetPrefix 会影响:

  • JS 文件(_next/static/chunks/*.js)
  • CSS 文件(_next/static/css/*.css)
  • 其他构建产物(_next/ 目录下的文件)

❌ assetPrefix 不会影响:

  • Next.js Image 组件的 src(需要配置 loader)
  • CSS 中的 url() 引用
  • public 目录下的静态文件直接访问
  • 普通 img、video 等标签的 src

⚠️ 重要提示

basePath 影响范围:
  • 所有页面路由(需使用 Link 组件或 useRouter)
  • API 路由(需使用 fetch 时注意路径)
  • Next.js Image 组件(自动处理)
  • Rewrite 的 source 也会被影响
assetPrefix 影响范围:
  • 只影响 _next/ 目录下的构建产物(JS/CSS)
  • 不影响 public 目录下的静态资源
  • 不影响 Image 组件(除非配置 loader)
  • 不影响 CSS 中的 url() 引用