NodeJS中API URL设为常量是否更优？代码实现对比咨询

我在Node.js应用里有一段生成请求API URL的代码，目前是用字符串模板直接生成的，代码如下：

private getApiUrl(): string {
    return `https://${domainExample}.host-example.com/API/version/example/${exampleValue}`;
}

我想知道，把这类URL抽离到单独的Constant.ts文件里作为常量管理是不是更佳实践？还是直接保留字符串字面量的写法也完全可以接受？

下面是我设想的Constant.ts实现示例：

export const BASE_URL = 'https://%s.qualtrics.com/API/v3/imported-data-projects/%s'
// 假设文件是分开的

private getApiUrl(): string {
  return util.format(BASE_URL, domainExample, exampleValue) ;
}

结论：抽离到常量文件属于更佳实践，但也要结合场景判断 #

• 优先选择常量管理的场景

  • 同一个基础URL在多处复用：抽离成常量后，后续修改域名、API版本这类固定部分时，只需改动一处，避免漏改多个分散的字符串字面量，降低出错概率。
  • 项目规模较大或多人协作：统一的常量文件能让团队快速定位所有API基础地址的定义，规范URL写法，避免各自拼接导致的格式混乱。
  • 需支持多环境切换：比如开发/测试/生产环境的域名不同，把基础URL放在常量文件里，能方便结合环境变量做切换，不用去各个业务代码里逐一修改。

• 保留字面量也可接受的场景

  • 该URL仅在当前文件中唯一使用，且项目很小、仅单人维护：这种情况下抽离的收益有限，直接写字符串模板反而更直观，无需额外跳转至常量文件查看。

另外补充个小建议：如果用TypeScript，比起util.format，用ES6模板字符串语法会更贴合TS风格，也可以把URL拆分成更细的常量，让职责更清晰：

// Constant.ts
export const BASE_PROTOCOL = 'https://';
export const API_DOMAIN = 'host-example.com';
export const API_BASE_PATH = '/API/version/example/';

// 业务代码中拼接
private getApiUrl(): string {
    return `${BASE_PROTOCOL}${domainExample}.${API_DOMAIN}${API_BASE_PATH}${exampleValue}`;
}

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