VSCode需安装Red Hat YAML和CircleCI Configuration Language Support扩展，并在.vscode/settings.json中配置schema URL，才能为.circleci/config.yml提供语法提示、校验与补全。
CircleCI配置文件在VSCode中没有语法提示？先确认扩展是否装对
VSCode默认不识别.circleci/config.yml，也不会为CircleCI YAML结构提供补全或校验——这不是VSCode的缺陷，而是因为CircleCI配置本身不属于YAML通用规范，需要额外支持。
核心问题在于：没有专用扩展时，VSCode只把config.yml当普通YAML处理，无法理解jobs、executors、orbs等CircleCI特有关键字，也就不会高亮错误、补全字段或跳转定义。
- 别装“CircleCI”命名的扩展（如
circleci-vscode），它们大多已过时或功能残缺，2026年仍在维护且有效的只有Red Hat YAML+CircleCI Configuration Language Support -
Red Hat YAML是基础依赖，必须启用；它提供YAML Schema校验能力，但本身不带CircleCI规则 -
CircleCI Configuration Language Support（作者：circleci）才是关键，它提供官方维护的JSON Schema，让VSCode知道docker下必须有image、steps里允许哪些run字段等
怎么让config.yml自动关联CircleCI Schema
即使装了两个扩展，VSCode也不会自动把.circleci/config.yml映射到CircleCI Schema——你得手动告诉它“这个文件用哪个规则校验”。
最可靠的方式是在项目根目录的.vscode/settings.json里显式声明：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
{
"yaml.schemas": {
"https://raw.githubusercontent.com/CircleCI-Public/circleci-config-schema/master/schema.json": [
".circleci/config.yml",
".circleci/config.yaml"
]
}
}- URL必须用
https://raw.githubusercontent.com/...这个地址，不是GitHub页面链接，否则Red Hat YAML加载失败 - 路径要写相对项目根目录的路径，不能写
./.circleci/config.yml或绝对路径 - 如果项目用
config.yaml而非config.yml，也得加进去，否则没提示 - 改完保存后，重新打开
config.yml文件，右下角状态栏会显示“YAML (CircleCI)”——说明Schema已生效
常见报错和对应修复：为什么提示“invalid type”或“missing required property”
Schema校验严格，但CircleCI实际运行时有时会宽松些，这就导致本地提示报错、CI却能跑通。典型矛盾点：
-
version: 2.1写成version: "2.1"（带引号）→ 提示Expected type number：Schema要求version是数字字面量，不能是字符串 -
docker:下面只写- image: cimg/node:16.15，漏掉- name→ 不报错，但如果你加了resource_class却没配name，部分orb会拒绝加载 - 在
steps里写- checkout: { path: "./src" }→ 提示Additional properties not allowed：CircleCI的checkout不支持path参数，只能用working_directory或后续run命令移动 - 用了
orbs但没在顶层声明orbs:块 → 整个文件标红，因为Schema要求orbs必须出现在version之后、jobs之前
调试Schema是否真生效：快速验证法
别靠肉眼等提示，用一个三秒验证动作：
- 在
config.yml任意steps下新增一行：- run: echo "test" - 把
echo删掉，光标停在r位置，按Ctrl+Space（Windows/Linux）或Cmd+Space（macOS） - 如果弹出
run、checkout、setup_remote_docker等CircleCI原生命令补全，说明Schema工作正常；如果只出key、value这种通用YAML字段，说明Schema没挂载成功 - 补全列表里还应包含常用orb指令，比如输入
aws-ecr会提示aws-ecr/push-image，这是CircleCI Configuration Language Support加载orb Schema的证据
Schema加载延迟或缓存失效很常见，如果补全没出来，先关掉文件再重开，不要重启VSCode——90%的情况只是YAML语言服务器没热更新。
