JS获取文件名但不包含扩展名的实现代码

作者:异步漫步时间:2026-11-18 12:58:51浏览:333

深入讲解使用 JavaScript 获取文件名且去除扩展名的多种实现代码。涵盖原生字符串切片法、正则表达式替换法以及 Node.js 官方 Path 模块解析,详尽分析多重句点、Linux 隐藏点文件及跨平台路径斜杠等边界情况的稳健处理方案。

JavaScript 核心技巧 适用环境:浏览器前端 / Node.js 全平台 代码零依赖
JS获取文件名但不包含扩展名的实现代码
概要预览:JavaScript 剥离目录与文件扩展名的核心转换过程

在 JavaScript 中获取文件名且去除扩展名,最稳妥的做法是先剥离路径中的目录部分获取基础文件名(Basename),再定位最后一个句点的位置并进行字符串切片。以下是一段兼容全路径、跨平台路径分隔符以及点开头隐藏文件的实用函数:

function getFileNameWithoutExt(filepath) {
  if (typeof filepath !== 'string' || filepath.trim() === '') return '';
  // 1. 兼容 POSIX(/) 与 Windows(\) 路径分隔符,提取最后一段纯文件名
  const basename = filepath.split(/[\/]/).pop() || '';
  // 2. 查找最后一个点号的索引
  const lastDotIndex = basename.lastIndexOf('.');
  // 3. 仅当点号存在且不在首位时截断,否则保留原名称(如 .gitignore)
  return lastDotIndex > 0 ? basename.slice(0, lastDotIndex) : basename;
}

// 验证调用
console.log(getFileNameWithoutExt('/path/to/archive.tar.gz')); // 输出: archive.tar
console.log(getFileNameWithoutExt('C:\Users\app\index.min.js')); // 输出: index.min
console.log(getFileNameWithoutExt('.gitignore')); // 输出: .gitignore
console.log(getFileNameWithoutExt('Makefile')); // 输出: Makefile

一、路径结构解构与提取难点

很多初学者在处理这个需求时,最容易写出的代码往往是 filepath.split('.')[0]。这种写法在面对复杂场景时极易产生两类致命缺陷:第一,如果传入的是完整路径(例如 /v1.0.0/dist/app.js),目录中的版本号含有句点,直接切片会导致文件名被错误截断为目录名片段;第二,如果文件本身具有复合命名(例如 vue.runtime.esm.js),直接按第一个句点切断就会丢失重要的标识信息。

要安全地提取不带扩展名的文件名,必须先在概念上把输入字符串拆解为三个独立部分:前置目录路径、主文件名(Stem Name)以及末尾扩展名(Extension)。

JS获取文件名但不包含扩展名的实现代码
图 1:文件完整路径结构与关键截取定位点剖析

从图 1 可以看出,有效解析需要抓住两个关键定位点:

  • 目录切分界限:在 Windows 下路径通常由反斜杠 \ 分隔,而在 Linux、macOS 与 Web URL 下则由正斜杠 / 分隔。通过正则表达式 /[\/]/ 可以同时涵盖这两种情况。
  • 末尾扩展名点位:只有文件名中从右往左数遇到的第一个句点(即 lastIndexOf('.')),才是真正的文件扩展名分界点。

二、原生切片法:高精度分步提取

字符串切片法依靠 JavaScript 原生的 lastIndexOf() 与 slice(),其内存开销最小,也是浏览器环境与高频数据循环处理中最推荐的方案。

JS获取文件名但不包含扩展名的实现代码
图 2:原生 JavaScript 提取无扩展名文件名的执行流程

如图 2 所示,整个处理逻辑被组织为一条严密的判断链条:

1. 路径剥离与基础名获取

const basename = filepath.split(/[\/]/).pop() || '';

通过正斜杠与反斜杠组成的字符集进行拆分,并通过 pop() 取得数组的最后一项。无论前面嵌套了多少层子目录,或者路径末尾是否带有特殊符号,这一步都能精准提取出纯粹的文件名(例如 bundle.release.min.js)。

2. 末尾点号的定位与边界保护

const lastDotIndex = basename.lastIndexOf('.');
return lastDotIndex > 0 ? basename.slice(0, lastDotIndex) : basename;

这里必须使用 lastDotIndex > 0 而不是 lastDotIndex !== -1。原因在于 Unix/Linux 环境下存在大量以句点开头的隐藏配置文件,例如 .gitignore、.npmrc、.env:

  • 对于 .gitignore,lastIndexOf('.') 的返回值是 0。如果仅判断 !== -1,执行 basename.slice(0, 0) 将返回空字符串 "",这显然违背了预期。
  • 对于无后缀的文件(例如 Makefile、LICENSE),lastIndexOf('.') 返回 -1,同样不满足 > 0,程序安全地返回原字符串。
  • 对于形如 .eslintrc.json 的文件,末尾句点索引为 9(大于 0),执行截取后得到 .eslintrc,准确去除了最外层的 .json。

三、正则表达式替换法:简洁单行方案

如果当前代码运行在只需要处理纯文件名(例如已经从 <input type="file"> 的 file.name 获取了基础名),或者偏好单行紧凑写法的场景,正则表达式提供了更为精炼的手段。

纯文件名的末尾替换

// 纯文件名(不含路径)去除扩展名
const getBaseNameOnly = (filename) => filename.replace(/\.[^/.]+$/, '');

console.log(getBaseNameOnly('dashboard.analytics.csv')); // 输出: dashboard.analytics
console.log(getBaseNameOnly('.bashrc')); // 输出: .bashrc
console.log(getBaseNameOnly('archive.tar.gz')); // 输出: archive.tar

该正则模式 /\.[^/.]+$/ 的各个部分含义如下:

  • \.:匹配一个字面量句点;
  • [^/.]+:匹配至少一个非斜杠且非句点的字符,确保仅捕获最后的扩展名段落;
  • $:锚定在字符串末尾。

包含完整路径的一体化正则

若需要在一个表达式内同时剥除路径与扩展名,可以利用捕获组提取目标片段:

function extractNameByRegex(filepath) {
  // 匹配:可选的目录路径 + 目标文件名 + 必须的扩展名或直接结尾
  const match = filepath.match(/(?:.*[\/])?([^\/]+?)(?:\.[^/.]*)?$/);
  return match ? match[1] : '';
}

console.log(extractNameByRegex('/var/www/html/login.template.html')); // 输出: login.template
console.log(extractNameByRegex('C:\data\2026\summary.xlsx')); // 输出: summary

四、Node.js 运行时:标准 path 模块

在 Node.js 服务端或前端工程化构建脚本中,推荐使用官方内置的 path 模块。标准库已经充分考虑了操作系统的路径差异,语义更具自解释性。

方式 1:利用 path.parse()

const path = require('path');

const filepath = '/home/user/workspace/script.spec.ts';
const parsed = path.parse(filepath);

console.log(parsed.name); // 输出: script.spec
console.log(parsed.ext);  // 输出: .ts
console.log(parsed.base); // 输出: script.spec.ts

path.parse() 返回一个包含 root、dir、base、ext 和 name 的对象,其中 name 属性直接就是去除扩展名后的主文件名。

方式 2:利用 path.basename 与 path.extname

const path = require('path');

function getNameViaBasename(filepath) {
  return path.basename(filepath, path.extname(filepath));
}

console.log(getNameViaBasename('/docs/api.guide.md')); // 输出: api.guide

path.basename() 的第二个可选参数允许传入要从结果末尾移除的后缀。结合 path.extname(),能够以极简的两层调用完成剥离。

跨平台注意:在 Windows 系统上运行的 Node.js 默认采用 path.win32,能够同时识别正反斜杠;但在 Linux 或 macOS 下,默认的 path.posix 不会把反斜杠 \ 当作路径分隔符。如果服务端需要处理 Windows 客户端上传的文件路径,应显式使用 path.win32.parse(filepath).name。

五、各类复杂边界场景解析效果对照

在实际业务中,用户输入的文件名五花八门。下表及对应图示展示了推荐的原生切片函数在各类测试用例中的解析结果:

JS获取文件名但不包含扩展名的实现代码
图 3:各类典型文件名与复杂边界场景的解析效果对照
场景分类 输入用例 期望输出 关键测试目的
标准文件 /docs/quarterly_report.pdf quarterly_report 验证常规单扩展名剥离与路径前缀过滤
多点版本命名 react.production.min.js react.production.min 验证仅截断末尾扩展名,保留中间版本点号
隐藏点文件 .gitignore .gitignore 验证 lastDotIndex === 0 时防止变成空字符串
带后缀配置 .eslintrc.json .eslintrc 验证隐藏配置文件能够剥离末尾 .json 并保留前置点
无扩展名 /etc/nginx/Dockerfile Dockerfile 验证 lastDotIndex === -1 时完整返回原名
目录含句点 D:1.0.8\export.data.csv export.data 验证路径目录中的句点与反斜杠不干扰文件名提取

六、复合扩展名(如 .tar.gz)的特殊处理

在处理归档压缩文件(例如 .tar.gz、.tar.bz2)或 TypeScript 声明文件(.d.ts)时,常规算法只会去除最右侧的一层后缀(例如 archive.tar.gz 变成 archive.tar)。

如果业务需求是将这类约定的复合后缀整体移除,可以维护一份常用复合扩展名白名单:

function getFileNameStrippingCompoundExt(filepath) {
  let basename = filepath.split(/[\/]/).pop() || '';
  
  // 常见复合扩展名列表
  const compoundExtensions = [
    '.tar.gz', '.tar.bz2', '.tar.xz',
    '.d.ts', '.spec.ts', '.test.js', '.min.js', '.min.css'
  ];
  
  const lowerName = basename.toLowerCase();
  for (const ext of compoundExtensions) {
    if (lowerName.endsWith(ext)) {
      return basename.slice(0, -ext.length);
    }
  }
  
  // 未匹配到复合后缀时,回退到常规单后缀逻辑
  const lastDotIndex = basename.lastIndexOf('.');
  return lastDotIndex > 0 ? basename.slice(0, lastDotIndex) : basename;
}

console.log(getFileNameStrippingCompoundExt('data-backup.tar.gz')); // 输出: data-backup
console.log(getFileNameStrippingCompoundExt('utils.d.ts'));         // 输出: utils
console.log(getFileNameStrippingCompoundExt('style.min.css'));       // 输出: style

七、三种实现方案横向评估与选型决策

不同场景对代码大小、执行性能及跨平台能力有着不同的侧重要求。图 4 对三种主要方案的技术指标进行了综合评估:

JS获取文件名但不包含扩展名的实现代码
图 4:三种核心实现方案的技术特性横向对比与选型指南

结合工程实践,具体选型建议如下:

  1. 前端高频渲染 / 文件上传组件:推荐使用方案一(原生字符串切片法)。该方法执行于 JavaScript 底层字符索引层面,没有正则表达式编译开销,且能完美防御点文件和空路径异常。
  2. 行内工具脚本 / 快速数据清洗:推荐使用方案二(正则表达式法)。无需声明多行变量,单行 name.replace(/\.[^/.]+$/, '') 即可嵌入数组转换或数据流链条中。
  3. Node.js 后端与构建系统:直接使用方案三(官方 path 模块)。充分利用 Node.js 官方对各种操作系统差异的标准化支持,语义明确且便于团队协同维护。
作者最新文章
相关文章
更多