如何用@pnp/sp启用SharePoint Online站点页面库的「新建文件夹」选项？

1. 权限前提 #

修改「站点页面」库的设置，你需要拥有站点所有者或具备库管理权限的编辑权限，否则仍会触发访问被拒错误。

2. 使用@pnp/sp启用文件夹创建功能 #

通过@pnp/sp操作「站点页面」库（内部默认名称为SitePages），修改其EnableFolderCreation属性为true即可启用文件夹创建选项：

TypeScript代码示例 #

import { sp } from "@pnp/sp";

// 初始化pnp/sp（根据你的站点URL调整）
sp.setup({
  sp: {
    baseUrl: "https://你的租户域名.sharepoint.com/sites/目标站点名称"
  }
});

async function enableFolderCreation() {
  try {
    // 定位到站点页面库
    const sitePagesList = sp.web.lists.getByTitle("站点页面");
    // 更新库属性，启用文件夹创建
    await sitePagesList.update({
      EnableFolderCreation: true
    });
    console.log("站点页面库已成功启用文件夹创建功能");
  } catch (error) {
    console.error("启用失败:", error);
  }
}

// 执行函数
enableFolderCreation();

代码说明 #

• EnableFolderCreation是文档库的核心配置属性，设为true后，库的「新建」菜单会自动显示「文件夹」选项，同时允许通过API创建文件夹。
• 如果是多语言站点，可将getByTitle的参数替换为对应语言的库名称，或通过getById传入列表ID进行定位。

3. 验证与后续操作 #

执行代码后，可通过两种方式确认设置生效：

• 打开「站点页面」库，检查「新建」菜单是否出现「文件夹」选项；
• 尝试用@pnp/sp创建文件夹，示例代码如下：

async function createFolder() {
  try {
    const newFolder = await sp.web.lists.getByTitle("站点页面").rootFolder.folders.add("测试文件夹");
    console.log("文件夹创建成功:", newFolder);
  } catch (error) {
    console.error("创建失败:", error);
  }
}

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