编写跨平台脚本需遵循POSIX标准，使用#!/bin/sh、避免Bash特有语法，采用os.path.join处理路径，注意sed等命令在GNU与BSD间的差异，Python中用subprocess和shutil等跨平台模块，统一LF换行与UTF-8编码，并通过多系统测试确保兼容性。
在 Linux 开发中，编写跨平台脚本（如 shell 或 Python 脚本）时，常需兼容不同操作系统（如 Linux、macOS、BSD，甚至 Windows 的 WSL 或 Git Bash）。要保证脚本能稳定运行，必须注意环境差异、工具版本、路径格式和系统调用等细节。
使用标准 Shell 并避免 Bash 特性
如果写 shell 脚本，目标是跨 Unix-like 系统，应优先使用 POSIX 标准的 sh，而非依赖 Bash 扩展：
- 脚本开头使用 #!/bin/sh 而非 #!/bin/bash
- 避免使用 Bash 专有语法，如 [[ ]], $(), 数组或 declare
- 用 test 或 [ ] 进行条件判断，确保在 dash、ash、zsh 中也能运行
- 测试脚本可在 macOS（默认 zsh）、Alpine Linux（使用 busybox sh）中验证
处理路径与文件分隔符差异
不同系统对路径的处理方式不同，尤其在混合环境（如 WSL 或 Cygwin）中：
- Python 脚本中始终使用 os.path.join() 或 pathlib.Path 构建路径
- 避免硬编码 "/" 或 "\"，让系统自动适配
- 读取配置或资源文件时，使用相对路径并基于 __file__ 定位根目录
注意命令行为差异
常见命令在不同系统上参数可能不一致：
Git Repo Analyzer
下载
智能分析 Git 仓库或普通链接，自动识别内容类型并执行相应处理流程。 支持四种类型：1) OpenClaw Skills 项目（风险检测与收藏）2) 论文/文档项目（加入 dashifu——wiki 待处理队列）3) 功能项目（评估 OpenClaw 学习可行性）4) 普通网页/文章（加入 dashifu——w...
立即学习“Python免费学习笔记（深入）”；
- sed、awk、grep 在 macOS（BSD 版本）和 Linux（GNU 版本）行为略有不同
- 避免使用 GNU 专属选项，如 sed -r（应改用 sed -E 以提高兼容性）
- 若必须使用高级功能，可通过脚本检测系统类型并切换命令参数
- 考虑用 Python 替代复杂文本处理，提升可移植性
Python 脚本：使用兼容库并声明依赖
Python 本身跨平台能力较强，但仍需注意细节：
- 使用 sys.platform 或 platform.system() 判断操作系统，做针对性处理
- 涉及系统调用时（如启动进程），优先用 subprocess 模块而非 os.system
- 避免直接调用 shell 命令，改用 shutil、tempfile 等跨平台封装模块
- 通过 requirements.txt 或 pyproject.toml 明确依赖，便于环境重建
统一换行符与编码
脚本在不同编辑器或 Git 配置下可能产生兼容问题：
- 确保脚本为 Unix 换行符（LF），避免 CRLF 导致 #! 失效
- Python 文件保存为 UTF-8 编码，源码中无需特别声明（Python 3 默认）
- Git 配置 core.autocrlf=input，防止 Windows 自动转换换行
基本上就这些。保持简单、依赖少、遵循标准，是跨平台脚本稳定的关键。测试多平台环境（可用 GitHub Actions 模拟 Linux/macOS/Windows）能提前发现问题。
