宝塔仅支持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()。这不是宝塔的问题，是开发环境和生产环境版本脱节。
- 查清项目最低要求的 PHP 版本（看
composer.json的"php": "^8.0"字段） - 在宝塔「软件商店」安装对应版本 PHP（如 PHP 8.4），再进「网站 → 设置 → PHP 版本」绑定，**不能只靠本地版本侥幸**
- 函数级兼容用
function_exists()或version_compare()包一层：if (function_exists('str_contains')) { return str_contains($s, $n); } else { return strpos($s, $n) !== false; }
权限与 session 隔离不是“开了就行”，配错就 502
宝塔在 CentOS/RHEL 上启 PHP-FPM 时，若没关 systemd socket activation（尤其 Debian 12+/Ubuntu 24.04），或 FPM 配置里 user/group 和宝塔站点运行用户（通常是 www）不一致，就会出现“PHP 已启动但网站 502”这种玄学问题。
立即学习“PHP免费学习笔记（深入）”；
- 检查是否被 systemd 接管：
systemctl status php-fpm8.4.socket，若 active，执行sudo systemctl stop php-fpm8.4.socket && sudo systemctl disable php-fpm8.4.socket - 确认 FPM 配置（如
/www/server/php/84/etc/php-fpm.d/www.conf）中user = www和group = www与宝塔站点用户一致 - 开启「Session 隔离」后，确保
session.save_path目录存在且www用户有读写权限，否则登录态丢失
