TypeScript环境变量赋值遇类型错误，修改后仍报错求助

Great question! Let's break down why you're seeing these errors and how to fix them properly.

First, let's unpack your original error:

[ts] Type 'string | 3000' is not assignable to type 'Number'. Type 'string' is not assignable to type 'Number'.

The core issue here is that process.env.PORT returns either a string (if the environment variable is set) or undefined (if it's not). When you use || 3000, the result becomes string | 3000—a mix of string and number types—which can't be assigned to the Number type. Also, a quick best practice note: in TypeScript, we use the primitive number type (lowercase) instead of the object Number (uppercase) for variable declarations.

Then, when you tried using parseInt, you hit a new error:

Argument of type 'string | undefined' is not assignable to parameter of type 'string'. Type 'undefined' is not assignable to type 'string'.

This happens because parseInt expects its first argument to be a string, but process.env.PORT could be undefined. TypeScript is protecting you from passing an invalid type to the function.

The Fixes #

Here are a few clean, TypeScript-friendly ways to resolve this:

1. Nullish Coalescing for Falsy-Safe Defaults

If you want to support valid falsy port values like 0 (which tells Node.js to use a random available port), use the nullish coalescing operator (??)—it only falls back to your default when the value is null or undefined:

const port: number = parseInt(process.env.PORT ?? '3000', 10);

2. Explicit Type Narrowing

For more clarity, you can explicitly check if process.env.PORT exists before parsing:

let port: number;
if (process.env.PORT) {
  port = parseInt(process.env.PORT, 10);
} else {
  port = 3000;
}

3. Concise Logical OR (for non-falsy ports)

If you don't need to support 0 as a valid port, you can use the logical OR operator to provide a default string before parsing:

const port: number = parseInt(process.env.PORT || '3000', 10);

All of these approaches will satisfy TypeScript's type checker and correctly handle both defined and undefined PORT environment variables.

内容的提问来源于stack exchange，提问作者Shamoon