小程序开放平台

文档中心
基础
路由
跳转
转发
界面
网络
支付
数据缓存
媒体
位置
开放接口
设备
XHSML
性能
第三方平台
文件
removeSavedFile
openDocument
getFileSystemManager
FileSystemManager方法
access
accessSync
appendFile
appendFileSync
copyFile
copyFileSync
getSavedFileList
getFileInfo
mkdir
mkdirSync
readdir
readdirSync
rmdir
rmdirSync
rename
renameSync
readFile
readFileSync
removeSavedFile
stat
statSync
saveFile
saveFileSync
truncate
truncateSync
unlink
unlinkSync
unzip
writeFile
writeFileSync
Stats
FileStats
错误码
数据分析
画布

fs.mkdirSync

开发
>
JS API
>
文件
>
FileSystemManager方法
>
mkdirSync
>
更新时间:2025-07-23 11:41:46

📌 从基础库 3.125.4 版本开始支持

功能描述

创建目录

参数

名称
类型
必填
说明
dirPathstring要创建的目录路径(本地路径)
recursiveboolean是否递归创建上级目录

示例代码

javascript
const fs = xhs.getFileSystemManager();

// 异步创建目录
fs.mkdir({
  dirPath: `${xhs.env.USER_DATA_PATH}/example`,
  recursive: true,  // 递归创建
  success(res) {
    console.log("目录创建成功", res);
  },
  fail(res) {
    console.error("目录创建失败", res);
  }
});

// 同步创建目录
try {
  fs.mkdirSync(`${xhs.env.USER_DATA_PATH}/example`, true);
  console.log("目录创建成功");
} catch(e) {
  console.error("同步创建失败", e);
}
该文档是否对您有帮助?