linter-cson不是开箱即用的独立校验插件，必须与linter框架共存并依赖系统级cson CLI工具；装了没反应，通常因未安装linter、缺少linter-ui-default、grammar未设为source.cson或Executable Path配置错误。
linter-cson 不是开箱即用的独立校验插件，它必须和 linter 框架共存，且依赖系统级 cson CLI 工具；装了没反应，大概率是缺依赖、grammar 没设对，或配置路径写错了。
为什么装了 linter-cson 却不报错？
常见静默失效原因：
- 只装了
linter-cson，但没装linter（作者 steelbrain）→ 控制台报Failed to provide linter services，设置页里根本看不到linter-cson的 Settings 选项 - 装了
linter和linter-cson，但没装linter-ui-default→ 错误日志可能出现在开发者工具控制台，但编辑器里零波浪线、状态栏始终显示0 problems - 当前文件 grammar 是
Plain text或Source code，不是source.cson→ 右下角点击切换 grammar，手动选CSON；Atom 不会自动识别.cson后缀为 CSON 语法，除非你显式配置过core.fileTypes -
linter-cson设置页里Executable Path留空或填错 → 它默认找全局cson命令，但多数人没装，导致直接跳过检查，不报错也不提示
如何让 linter-cson 找到并调用 cson CLI？
linter-cson 本身不解析 CSON，它调用命令行工具 cson（来自 cson-parser 包），必须确保该命令在 PATH 中可执行，或显式指定路径。
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 推荐本地项目级安装（避免环境 PATH 冲突）：
npm install cson-parser --save-dev
然后在 Atom 设置 → Packages →linter-cson→ Settings 中，把Executable Path改成：node_modules/.bin/cson - Mac 用户若用
nvm，从桌面图标启动 Atom 会导致 PATH 丢失cson；改用终端运行：atom --new-window . - Windows 用户注意路径分隔符：填
node_modules\.bin\cson.cmd（不是/），否则插件启动失败但无提示 - 验证是否生效：终端进项目根目录，运行
node_modules/.bin/cson --version；若报错，linter-cson就不会工作
怎样确保 .cson 文件被正确识别为 source.cson？
Atom 默认不把 .cson 当作 CSON 语法处理，尤其 config.cson 这类文件常被识别为 Plain text，导致 linter-cson 完全不触发。
- 在
~/.atom/config.cson中添加：core:
fileTypes:
".cson": "source.cson" - 如果用的是旧版 Atom（language-cson 插件已启用（它提供
source.csongrammar）；新版 Atom 内置该语言支持，但插件若被禁用，grammar 仍不可用 - 重启 Atom 或执行
Window: Reload（Cmd+Alt+R/Ctrl+Alt+R），再打开任意.cson文件，右下角应显示CSON而非Plain text
遇到 Unexpected token 但语法明明合法？
CSON 允许注释、缩进定义结构、无引号键名，但 cson CLI 默认按严格模式解析——比如缩进混用空格/Tab、末尾多逗号、键名含点号未加引号，都会直接报错。
- 检查缩进：全部统一用 2 或 4 空格，禁止 Tab；CSON 对缩进敏感，差一个空格就解析失败
- 键名含特殊字符（如
.、-）必须加双引号："tree-view.openFilesWithOneClick": true，不能写成tree-view.openFilesWithOneClick: true - 数组末尾不能有逗号：
["welcome"]✅，["welcome",]❌ - 注释前必须有空格：
"welcome" # 注释✅，"welcome"#注释❌
最易被忽略的是：修改 config.cson 后保存即热加载，但语法错误会导致 Atom 下次启动失败；一旦打不开，立刻删掉最后加的几行重试——别指望 Atom 给你友好的错误定位。
