宝塔仅支持Linux系统，Windows上无法安装运行；开发时需注意路径分隔符、大小写敏感、换行符、PHP版本兼容性及权限配置等跨平台问题。
宝塔 本身不跨 Windows —— 它**仅支持 Linux 系统**（Ubuntu/Debian/CentOS/RHEL/Alibaba Cloud Linux 等），Windows 上无法安装或运行宝塔面板。所以所谓“宝塔在 Windows 和 Linux 的差异”，本质是：**你在 Windows 开发、却要部署到宝塔所在的 Linux 服务器**，这时 PHP 代码的跨平台兼容性问题才真正暴露。
下面直击开发中最常翻车的几个点：
路径拼接必须用 DIRECTORY_SEPARATOR，硬写 / 或 \ 必崩
Windows 开发时写 "C:\www\config.php" 或 "./uploads/file.jpg" 看似正常，一上宝塔（Linux）就报 failed to open stream: No such file or directory —— 因为 Linux 不认 \，且对大小写敏感，还可能因路径中混用斜杠导致 realpath() 解析失败。
- 所有拼接路径的地方，一律用
DIRECTORY_SEPARATOR替代手动斜杠：$path = __DIR__ . DIRECTORY_SEPARATOR . 'conf' . DIRECTORY_SEPARATOR . 'db.php'; - 读取用户上传路径、日志目录、缓存路径等动态路径时，先用
str_replace(['/', '\\'], '/', $input)归一化，再统一转为当前系统分隔符 - 避免
include 'Classes/Db.php'这类写法；Linux 下若实际文件名是db.php，直接报错 —— 开发阶段就在 WSL 或 Docker 容器里跑，提前暴露大小写问题
PHP_EOL 不是可选项，是换行安全线
Windows 下 file_put_contents('log.txt', "msg\r\n") 写出 CRLF，Linux 宝塔环境读 file('log.txt') 会把 "msg\r" 当成一行，末尾多出 \r，JSON 解析失败、CSV 导入错位、配置写入后多空行……全由此起。
- 写文件统一用
PHP_EOL：file_put_contents($file, $content . PHP_EOL, FILE_APPEND | LOCK_EX); - 读文件后若需处理每行内容，先
trim($line, "\r\n")再操作，别依赖file()自动去\r - 日志类、导出类、模板渲染中涉及换行的逻辑，全部搜索替换掉硬编码的
"\n"或"\r\n"
宝塔不帮你兜底 PHP 版本差异，str_contains() 在 PHP 7.4 就炸
你在 Windows 本地装了 PHP 8.4，写了 if (str_contains($url, 'admin'))，代码跑得飞起；但宝塔默认可能只装了 PHP 7.4 —— 上线直接报 Call to undefined function str_contains()。这不是宝塔的问题，是开发环境和生产环境版本脱节。
