SharePoint 365列表JSON列格式化代码无效问题排查

不需要管理员权限，列表所有者权限完全足够配置列级JSON格式。以下是常见的失效原因及排查点：

1. JSON代码语法或逻辑错误 #

• 直接使用SharePoint内置的JSON编辑器验证，它会实时提示语法问题（比如引号不闭合、逗号多余、括号不匹配），修正后再保存。
• URL列宽度控制：确保代码作用于列显示格式，schema地址正确，示例正确结构：

  {
    "$schema": "https://developer.microsoft.com/json-schemas/sp/v2/column-formatting.schema.json",
    "elmType": "div",
    "style": {
      "width": "150px",
      "white-space": "nowrap",
      "overflow": "hidden",
      "text-overflow": "ellipsis"
    },
    "children": [
      {
        "elmType": "a",
        "txtContent": "@currentField.description",
        "attributes": {
          "href": "@currentField",
          "target": "_blank"
        }
      }
    ]
  }
  

• 下拉列条件高亮：确认代码中引用的选项值和列表实际选项完全一致（大小写、空格都不能错），示例结构：

  {
    "$schema": "https://developer.microsoft.com/json-schemas/sp/v2/column-formatting.schema.json",
    "elmType": "div",
    "attributes": {
      "class": "=if(@currentField == '已完成', 'sp-field-severity--success', if(@currentField == '进行中', 'sp-field-severity--warning', 'sp-field-severity--blocked'))"
    },
    "children": [
      {
        "elmType": "span",
        "style": {
          "display": "inline-block",
          "padding": "0 4px"
        },
        "attributes": {
          "iconName": "=if(@currentField == '已完成', 'CheckMark', if(@currentField == '进行中', 'Forward', 'Error'))"
        }
      },
      {
        "elmType": "span",
        "txtContent": "@currentField"
      }
    ]
  }
  

2. 应用范围与保存操作问题 #

• 必须在列设置的**「格式化列」选项卡下粘贴代码，而非「格式化表单」；粘贴后务必点击「保存」**，若页面卡顿可刷新后重新操作验证。
• 检查当前视图：如果列表使用了自定义现代视图，部分视图设置可能强制调整列宽或样式，导致JSON格式被覆盖，可切换到默认视图测试。

3. 列类型不匹配 #

• URL列必须是**「超链接或图片」**类型，文本列无法识别JSON中针对URL字段的引用逻辑。
• 下拉选项列必须是**「选择（下拉菜单）」**类型，手动输入的文本列（即使内容为下拉样式）无法触发条件判断。

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