Nextjs：无法从 static 文件夹加载图像

Question

How can I load images in a component in Next.js? Do I have to build the project first? If yes, is there a way to load the images without building first? I cannot get this to work, no matter what I try.

Answer 1

from the docs:

Next.js can serve static files, like images, under a folder called public in the root directory. Files inside public can then be referenced by your code starting from the base URL (/).

So, first add an image to public/my-image.png and then you can reference it:

<img src="/my-image.png" />

I think next.js will have a watch on this directory so you won't need to re start your server every time you put something in there.

Answer 2

Another way I find out Next Images

installation : npm install --save next-images

or yarn add next-images

Usage :

Create a next.config.js in your project

// next.config.js
const withImages = require('next-images')
module.exports = withImages()

Optionally you can add your custom Next.js configuration as parameter

// next.config.js
const withImages = require('next-images')
module.exports = withImages({
  webpack(config, options) {
    return config
  }
})

And in your components or pages simply import your images:

export default () => <div>
  <img src={require('./my-image.jpg')} />
</div>

or

import myImg from './my-image.jpg'

export default () => <div>
  <img src={myImg} />
</div>

Answer 3

The static directory has been deprecated. Place files in public/static directory

Answer 4

With Next 10+ To serve an optimized image:

import Image from 'next/image'
<Image src={'banner.jpg'} alt='Home Page' width={100} height={100} />

Place the image in the public folder. All the referenced images must be present in the public folder at the build time. Image hot deployment will not work for images that reside in the public folder. You also can refer to cross-domain images with <Image> tag.

<Image src={'https://www.example.com/banner.jpg'} alt='Home Page' width={100} height={100} />

To allow cross-domain images, ensure to add the below entry to your next.config.js

module.exports = {
images: {
    domains: ['www.example.com'],
},

}

Answer 5

what i like to do for directing to images is using environment variables . in next.js they are easily set in next.config.js file like below:

// next.config.js

module.exports = {
    env: {
      PUBLIC_URL: '/',
    }
};

then you can direct to your publics path wherever it is by using process.env.PUBLIC_URL like below:

<img src={`${process.env.PUBLIC_URL}/my-image.jpg`} />

the advantages of using PUBLIC_URL environment variable over hard coding the path is that you can use another path for when file arrangements change (like in server). for then you could set conditionally which PUBLIC_URL value to use in production and development.

Answer 6

From Next.js v11 onwards, one can now directly import images without any additional config or dependencies. Official example (comment mine):

import Image from 'next/image'
import profilePic from '../public/me.png'

function Home() {
  return (
    <>
      <h1>My Homepage</h1>
      <Image src={profilePic} alt="Picture of the author" />
      {/* <img src={profilePic.src} alt="Picture of the author" /> */}
      <p>Welcome to my homepage!</p>
    </>
  )
}

export default Home

Docs: next/image

Answer 7

You can load an image in Next.js in many ways.

#1. Local Images

Assumed, you have one image on your public directory with the name is your_image_name.jpg

You can render an image using following this code.

import Image from 'next/image'
import YourImage from '../public/your_image_name.jpg'

export default function AppLayout(){
  return (
    <>
        <h2>Hello World</h2>
        <Image
            src={YourImage}
            alt="Awesome image"
            ...
        />
    </>
  )
}

#2. Remote Images

You will use an external image, like your public website directory or third-party website.

import Image from 'next/image'

export default function AppLayout() {
  return (
    <>
      <h2>Hello World</h2>
      <Image
        src="https://images.pexels.com/photos/792199/pexels-photo-792199.jpeg?crop=entropy&cs=srgb&dl=pexels-nao-triponez-792199.jpg&fit=crop&fm=jpg&h=427&w=640"
        alt="Awesome Images"
        width={500}
        height={500}
        ...
      />
    </>
  )
}

Don't forget to create a new file next.config.js in the main directory. In the example, you follow configuration.

module.exports = {
  images: {
    domains: ['images.pexels.com'],
  },
}

It works for me.

For many options, you can read the Next.js docs .

Thanks :)

Answer 8

I will add here one obvious case, that is usually easily forgotten. It keeps appearing when one re-structure a site page and our IDE "silently fails" to update the paths of a related file/component or simply when one is more tired or distracted.

If you are using a page inside a folder ex: mysiteDomain/pagefolder/page You should be careful when using relative path. Something like <img src="logo.png" /> should be changed it to <img src="../logo.png" /> since the compiled page will also be inside a folder pagefolder . The path in the src attribute will be relative to the compiled page.

As an alternative, you could simply use an absolute path like for ex <img src="/logo.png" /> . The path in the src attribute will be relative to the compiled root of the site.

Answer 9

Do NOT put public into /src !

In my case, I had a src dir into which I put my pages etc., which is an option described here . But I ALSO accidentally moved the public dir there. This will mess nextjs up -- you need to keep public in the root dir.

Answer 10

After running next build && next export and your images are not visible do this:

// next.config.js
/** @type {import('next').NextConfig} */

module.exports = {
  reactStrictMode: true,

  images: {
    loader: "custom",
    loaderFile: "./imageLoader.js",
  },

  assetPrefix: "./",

  env: {
    // dev does not need static path
    ROOTDIR: process.env.NODE_ENV === "development" ? "" : "file:///C:/Users/.../out",
  },
};

Create an imageLoader.js too in the root project

export default function imageLoader({ src, width, quality }) {
  return `process.env.NODE_ENV === "development" ? "" : "file:///C:/Users/.../out${src}?w=${width}?q=${quality || 75}`;
}

Where file:///C:/Users/.../out refers to full path to the root of your build

Now you can append process.env.ROOT before "/*"