CodeIgniter可跨平台运行但需适配四方面：路径分隔符（统一用realpath(FCPATH)）、CLI执行上下文（显式定义FCPATH）、Apache配置（AllowOverride All及RewriteBase匹配）、数据库驱动差异（如PostgreSQL需RETURNING、SQLite需启用外键）。
CodeIgniter 能跨平台运行，但不是“扔过去就能用”。Windows 和 Linux 下的路径分隔符、权限模型、Apache 配置默认值、CLI 执行上下文这四点不一致，直接导致常见报错：failed to open stream、Unable to determine what type of request has been made、Class not found、403/404 页面，甚至数据库插入 ID 拿不到。
Windows 与 Linux 的路径分隔符和常量行为差异
Windows 下 FCPATH 常含反斜杠（C:\xampp\htdocs\myapp\），Linux 下全是正斜杠（/var/www/myapp/）。虽然 PHP 内置函数如 is_dir() 在 Windows 上对混用斜杠容忍度高，但自定义加载器、第三方扩展或 require_once() 链路中一旦做字符串比对或正则匹配，就会失败。
- 永远用
realpath(FCPATH)规范化后再拼子路径，别手动加\或/ - 不要修改
FCPATH定义本身——它由框架自动推导，硬改会破坏初始化逻辑 - 构造绝对路径时优先用
APPPATH、BASEPATH等内置常量，它们已在框架层做了平台适配 - 检查
config/autoload.php（CI3）或app/Config/Autoload.php（CI4）里有没有硬编码的相对路径（如../logs/），这类写法绕过所有常量，跨平台必挂
CLI 模式下 FCPATH 推导失效问题
Linux 下 CLI 启动时 getcwd() 返回当前 shell 路径；Windows 下若在项目目录里双击运行 php index.php，FCPATH 就会错成当前目录，而非 Web 入口所在目录，导致 APPPATH、VIEWPATH 全部偏移，后续加载全崩。
- CLI 启动必须显式指定完整入口路径：
php /var/www/myapp/index.php welcome，而不是进到myapp/目录后执行php index.php - 在
index.php开头加兜底逻辑：if (php_sapi_name() === 'cli') { define('FCPATH', __DIR__ . DIRECTORY_SEPARATOR); } - CI4 的 CLI 命令（如
spark）内部已处理该问题，但自定义脚本仍需手动防护
Apache 配置与 .htaccess 在双平台下的生效条件
Windows XAMPP 默认 AllowOverride None，且 .htaccess 文件名大小写不敏感，但配置项值（如 All）必须首字母大写；Linux 下文件系统区分大小写，.HTACCESS 或 .htaccess 写错一个字母就彻底失效。
- 确认
httpd.conf中LoadModule rewrite_module modules/mod_rewrite.so前无# - 对应
<Directory ""/xampp/htdocs">区块内必须有AllowOverride All（注意是All，不是all或None） - CI4 的入口在
public/目录，public/.htaccess必须存在且RewriteBase值要严格匹配部署路径（如放在htdocs/myapp/，就得写RewriteBase /myapp/public/） - 临时验证法：能打开
http://localhost/myapp/public/index.php/home说明框架 OK；打不开http://localhost/myapp/home就是重写规则没生效
数据库驱动在不同系统下的 last_insert_id() 行为不一致
insert_id() 不是跨数据库通用接口。MySQL 返回可靠，PostgreSQL 需 RETURNING，SQLite 外键默认关闭，SQL Server 对 Unicode 缺 N' 前缀就乱码——这些在 Windows 开发时可能被掩盖（比如本地 MySQL + 中文测试数据看似正常），一上 Linux 生产环境立刻暴露。
- PostgreSQL 场景下，别依赖
$this->db->insert_id()，改用$this->db->query("INSERT INTO t (x) VALUES (?) RETURNING id", [$val])->row()->id - SQLite 连接后立即执行
$this->db->query('PRAGMA foreign_keys = ON')，否则外键约束不生效 - SQL Server 查询中涉及中文或 emoji，优先用绑定参数（
$this->db->like('name', $kw)），拼接时手动加N'前缀："N'" . $this->db->escape_str($str) . "'" - Oracle 驱动下
insert_id()永远返回 0，必须靠序列（SELECT seq_name.NEXTVAL FROM DUAL）+ 触发器实现
最易被忽略的是：路径常量（APPPATH、BASEPATH）在 index.php 加载框架前就已固化，后续任何配置文件（包括环境配置）都无法修改它们——这意味着你不能靠 ENVIRONMENT 切换来让开发/生产环境用不同 APPPATH，只能在 index.php 里写条件判断 + define()。
