Engineering Tools for AI

プログラミング

開発サーバーとデプロイ用語

ローカル開発サーバー、ネットワークURL、ポート、ビルド、デプロイ、警告、Webエラーの用語集です。

42

ローカル開発

localhost

localhost

http://localhost:3001

意味

A hostname that points back to the same computer that is running the browser or command.

使い方

Use localhost when checking the site on the same Mac or PC where the dev server is running.

注意

A phone or tablet has its own localhost, so it cannot use your Mac's localhost address.

http://localhost:3001

依頼例

Open the local site at localhost and check the new reference page.

ローカル開発

127.0.0.1

127.0.0.1

http://127.0.0.1:3001

意味

A loopback IP address that also points to the same local computer.

使い方

It is often interchangeable with localhost for same-device testing.

http://127.0.0.1:3001

依頼例

Try 127.0.0.1 if localhost does not resolve correctly.

ローカル開発

Dev server

Dev server

npm run dev

意味

A server used while developing, with fast rebuilds and development-only features.

使い方

Use it to preview changes before building or deploying the site.

注意

Dev server behavior is not always identical to deployed production behavior.

npm run dev

依頼例

Start the dev server so I can check the page on my iPhone.

ローカル開発

Port

Port

http://localhost:3001

意味

A number that identifies which server process should receive the connection on a machine.

使い方

If one server uses port 3001, another server must use a different port such as 3002.

http://localhost:3001

依頼例

If port 3001 is already in use, start the dev server on another port.

ローカル開発

Local URL

Local URL

Local: http://localhost:3001

意味

The address used from the same device where the dev server is running.

使い方

Use Local URL for desktop browser checks on the development machine.

Local: http://localhost:3001

依頼例

Tell me the Local URL after starting the dev server.

ネットワーク接続

Network URL

Network URL

Network: http://172.30.1.55:3001

意味

An address other devices on the same network can use to reach the dev server.

使い方

Use it when checking the site from an iPhone, iPad, or another computer on the same Wi-Fi.

注意

The dev server must listen on a network-accessible host such as 0.0.0.0.

Network: http://172.30.1.55:3001

依頼例

Start the dev server with a Network URL so I can test it on my iPad.

ネットワーク接続

IP address

IP address

172.30.1.55

意味

A numeric address that identifies a device on a network.

使い方

A LAN IP lets another device on the same Wi-Fi reach your dev server.

注意

Local network IPs can change when Wi-Fi or router conditions change.

172.30.1.55

依頼例

Use the current LAN IP when adding allowedDevOrigins for device testing.

ネットワーク接続

Host

Host

--hostname 0.0.0.0

意味

The address a server binds to when it starts listening for requests.

使い方

Binding to 0.0.0.0 allows the dev server to be reachable from other devices on the network.

--hostname 0.0.0.0

依頼例

Run the dev server with hostname 0.0.0.0 for phone testing.

ネットワーク接続

Same network

Same network

Mac and iPhone on the same Wi-Fi

意味

Devices connected to the same local network, usually the same Wi-Fi router.

使い方

A phone can reach your Mac's dev server only when network settings allow it.

Mac and iPhone on the same Wi-Fi

依頼例

Check that the iPhone and Mac are on the same network before debugging the site.

Next.js の動作

allowedDevOrigins

allowedDevOrigins

allowedDevOrigins: ['172.30.1.55']

意味

A Next.js development setting that allows specific origins to access development resources.

使い方

It can be needed when testing a Next dev server from a phone or tablet using a LAN IP.

注意

This is a development setting. Deployed static sites do not use the same dev-resource access path.

allowedDevOrigins: ['172.30.1.55']

依頼例

Add my current LAN IP to allowedDevOrigins for development testing.

ネットワーク接続

Cross-origin

Cross-origin

Blocked cross-origin request

意味

A request between different origins, where scheme, host, or port differs.

使い方

Development tools may block cross-origin access to sensitive dev resources by default.

Blocked cross-origin request

依頼例

Explain whether this cross-origin warning affects production deployment.

Next.js の動作

HMR

HMR

/_next/webpack-hmr

意味

Hot Module Replacement updates the browser during development without a full reload.

使い方

If HMR dev resources are blocked, the page may load but interactive updates or scripts can behave strangely in development.

注意

HMR is development-only and is not part of the final static export.

/_next/webpack-hmr

依頼例

Check whether the iPhone issue is caused by blocked HMR dev resources.

Next.js の動作

Turbopack

Turbopack

Next.js 16.2.5 (Turbopack)

意味

A bundler used by Next.js for development and build workflows.

使い方

You may see its name in dev server or build output.

Next.js 16.2.5 (Turbopack)

依頼例

Summarize the Turbopack output and tell me whether the build succeeded.

Next.js の動作

App Router

App Router

src/app/[locale]/reference/page.tsx

意味

The Next.js routing system based on the app directory.

使い方

Adding a page.tsx file under a folder creates a route.

src/app/[locale]/reference/page.tsx

依頼例

Add the new reference page using the App Router folder structure.

Next.js の動作

generateStaticParams

generateStaticParams

generateStaticParams()

意味

A Next.js function that declares which dynamic routes should be generated at build time.

使い方

Locale pages use it to create /en, /ko, /ja, and other language paths.

generateStaticParams()

依頼例

Make sure the new reference page has generateStaticParams for all locales.

ビルドと出力

Build

Build

npm run build

意味

The process that compiles and prepares the site for production or static output.

使い方

Run build before deployment to catch TypeScript, route, and static generation problems.

npm run build

依頼例

Run the build and confirm the new route is generated.

ビルドと出力

Lint

Lint

npm run lint

意味

A static code check that catches style, correctness, and framework-rule issues.

使い方

Lint is a quick check before build or commit.

npm run lint

依頼例

Run lint after editing the reference pages.

ビルドと出力

Static export

Static export

output: "export"

意味

A build output where pages are generated as static files instead of needing a running server.

使い方

Static export is useful for hosting sites as prebuilt HTML, CSS, and JavaScript files.

注意

Some server-only features do not work with static export.

output: "export"

依頼例

Keep the new page compatible with static export.

ビルドと出力

SSG

SSG

● (SSG) prerendered as static HTML

意味

Static Site Generation creates pages at build time.

使い方

Reference pages with generateStaticParams are generated for each locale during build.

● (SSG) prerendered as static HTML

依頼例

Confirm that the reference route appears as SSG in the build output.

ビルドと出力

Prerender

Prerender

prerendered as static content

意味

Rendering a page before a user requests it, usually during build.

使い方

Prerendered pages load fast because HTML already exists.

prerendered as static content

依頼例

Check that all locale pages are prerendered successfully.

ビルドと出力

Bundle

Bundle

static JS bundle

意味

Compiled files that combine code and dependencies for the browser.

使い方

Large bundles can affect load speed and should be watched as the site grows.

static JS bundle

依頼例

Avoid adding a heavy library just for a simple reference page.

デプロイ

Deploy

Deploy

deploy static output

意味

Publishing the built site so users can access it on the web.

使い方

Deployment happens after local checks, lint, and build pass.

deploy static output

依頼例

Do not deploy yet; just prepare the page and run build.

デプロイ

Production

Production

production deployment

意味

The real deployed environment that users access.

使い方

Production should be tested differently from the local dev server because dev-only features are absent.

production deployment

依頼例

Explain whether this warning affects production or only development.

デプロイ

Hosting

Hosting

static hosting provider

意味

The service or server that stores and serves the deployed site files.

使い方

Static export can be served by static hosting when server logic is not required.

static hosting provider

依頼例

Make sure the output works on static hosting.

デプロイ

Domain

Domain

example.com

意味

The human-readable address users type to reach a site.

使い方

A domain points to the deployed hosting location through DNS.

example.com

依頼例

Do not hard-code localhost in links that should work on the production domain.

デプロイ

DNS

DNS

A record / CNAME record

意味

The system that maps a domain name to the server or hosting target.

使い方

DNS must be configured correctly for a custom domain to reach the deployed site.

A record / CNAME record

依頼例

Explain whether the issue is a DNS problem or an app build problem.

デプロイ

Cache

Cache

clear browser cache

意味

Stored copies of files or responses used to load pages faster.

使い方

After deployment, old cached files can make a browser show a previous version for a while.

clear browser cache

依頼例

Check whether the old page is still showing because of cache.

実行環境

Node.js

Node.js

node --version

意味

A JavaScript runtime used to run development tools, build scripts, and servers.

使い方

Next.js dev and build commands run on Node.js.

node --version

依頼例

Tell me whether this warning comes from Node.js, Next.js, or my app code.

実行環境

npm

npm

npm run build

意味

A package manager and script runner commonly used in JavaScript projects.

使い方

package.json defines scripts such as dev, lint, and build that npm can run.

npm run build

依頼例

Run the npm build script and summarize the result.

実行環境

package.json

package.json

"scripts": { "dev": "next dev -p 3001" }

意味

A project file that defines scripts, dependencies, and package metadata.

使い方

Check package.json to know which commands the project expects you to run.

"scripts": { "dev": "next dev -p 3001" }

依頼例

Check package.json before deciding which dev command to run.

実行環境

Environment variable

Environment variable

NEXT_PUBLIC_SITE_URL=https://example.com

意味

A value supplied to the app or build environment outside the source code.

使い方

Environment variables are used for site URLs, API keys, and deployment-specific settings.

注意

Secrets should not be exposed through public client-side variables.

NEXT_PUBLIC_SITE_URL=https://example.com

依頼例

Do not hard-code the production site URL if an environment variable already exists.

エラーと警告

404

404

404 Not Found

意味

An error meaning the requested page or file was not found.

使い方

It can happen when a route was deleted, renamed, or not generated in static output.

404 Not Found

依頼例

Check whether the old programming-basics URL now returns 404 after removal.

エラーと警告

500

500

500 Internal Server Error

意味

An error meaning the server failed while handling the request.

使い方

In development, the terminal or browser overlay usually shows the source error.

500 Internal Server Error

依頼例

If a 500 appears, inspect the terminal error and identify the failing file.

エラーと警告

Module not found

Module not found

Module not found: Can't resolve '@/lib/programming'

意味

An error meaning an import points to a file or package that cannot be found.

使い方

It often happens after moving, deleting, or renaming files without updating imports.

Module not found: Can't resolve '@/lib/programming'

依頼例

Find and update any imports that still point to the removed file.

エラーと警告

Export not found

Export not found

Export programmingBasicsCopy doesn't exist

意味

An error meaning a file exists, but the requested named export is not provided by that file.

使い方

It can happen when a data object is renamed but imports still use the old name.

Export programmingBasicsCopy doesn't exist

依頼例

Replace the old export name with the new one everywhere.

エラーと警告

EADDRINUSE

EADDRINUSE

listen EADDRINUSE: address already in use 0.0.0.0:3001

意味

An error meaning another process is already using the requested host and port.

使い方

Use another port or stop the existing server if you intentionally want to replace it.

listen EADDRINUSE: address already in use 0.0.0.0:3001

依頼例

If EADDRINUSE appears, tell me which port is busy and use a different one.

エラーと警告

DeprecationWarning

DeprecationWarning

[DEP0205] DeprecationWarning: module.register() is deprecated

意味

A warning that an API still works now but may be removed or changed later.

使い方

Warnings should be noticed, but they are not always build-blocking errors.

[DEP0205] DeprecationWarning: module.register() is deprecated

依頼例

Tell me whether this DeprecationWarning is harmless or requires a code change.

エラーと警告

Hydration

Hydration

Hydration failed because the server rendered HTML didn't match

意味

The process where client-side JavaScript connects to server-rendered HTML.

使い方

Mismatch errors happen when server and client render different initial content.

Hydration failed because the server rendered HTML didn't match

依頼例

If hydration fails, check which component renders differently on the client.

コマンド

npm run dev

npm run dev

npm run dev

意味

A project script that starts the local development server.

使い方

Use it while editing pages and checking changes locally.

npm run dev

依頼例

Run npm run dev and give me the Local and Network URLs.

コマンド

npm run build

npm run build

npm run build

意味

A project script that creates the production build or static export.

使い方

Run it after changes to ensure the app can be generated successfully.

npm run build

依頼例

Run npm run build and summarize any warnings or failures.

コマンド

npm run lint

npm run lint

npm run lint

意味

A project script that runs lint checks.

使い方

Run it before build to catch many code issues quickly.

npm run lint

依頼例

Run lint before building the site.

コマンド

curl

curl

curl -I http://localhost:3001/ko

意味

A command-line tool for making HTTP requests and checking responses.

使い方

curl can quickly check whether a local or deployed page responds with 200, 404, or another status.

curl -I http://localhost:3001/ko

依頼例

Use curl to check whether the new reference route returns 200.