本文约 2,687 字，预计阅读 7 分钟。文中命令与配置均经过实测，可直接参考执行。
引言
把 WordPress 上传好，打开域名进入安装页，填完数据库账号密码点”提交”，结果页面没有跳到”运行安装”，而是弹出一句让你手心冒汗的提示：无法写入 wp-config.php 文件，请手动创建配置文件。有的翻译版本是”抱歉，我不能写入 wp-config.php 文件”。很多人当场懵住：数据库明明连上了，怎么又卡在写文件这一步？其实这跟数据库没有任何关系，它说的是 WordPress 想自动帮你生成那个保存数据库信息的配置文件，却被服务器的权限规则拦了下来。这在国内主机、虚拟空间上非常常见，尤其是用主机自带文件管理器、或上传时权限被改乱的场景。好消息是，这个问题不用重装、不用换空间，只要按下面两种思路处理，几分钟就能让安装继续跑下去。
故障原因分析
1. 网站目录权限不够，Web 运行用户没有写权限。 WordPress 是通过 PHP 进程（Apache 用户、nginx 用户或 www 用户）去写文件的。如果目录权限是 755 而所有者不是 Web 用户，写操作就会被拒绝。
2. 文件所有者和 Web 用户不一致。 你用 FTP 上传时文件可能归属为 FTP 账号，而 PHP 以 www 身份运行，两者不是同一个用户，自然写不进去。
3. 主机出于安全把写入锁死了。 部分虚拟主机默认禁止程序在网站根目录创建 PHP 文件，这是一种常见的安全策略；遇到这种情况，自动写入这条路基本走不通，只能改用手动创建配置文件的方式。
4. 磁盘已满或目录只读。 空间配额用尽，或根目录被挂载为只读，也会导致写入失败。
5. 安装目录选错了。 比如 WordPress 实际在子目录，而你给根目录设了权限，或反过来，权限加在了错误的地方。
分步解决方案
方法一：临时调整目录权限，让安装自动生成
先定位到 WordPress 所在目录，修改文件所有者并给目录写权限（Linux 环境）：
# 进入网站根目录后执行，www 为 Web 用户，不同主机可能是 www-data 或 nobody
chown -R www:www /www/wwwroot/你的站点目录
find /www/wwwroot/你的站点目录 -type d -exec chmod 755 {} \;
find /www/wwwroot/你的站点目录 -type f -exec chmod 644 {} \;如果只是想让安装暂时通过，可临时给根目录 775 权限，装完再改回来：
chmod 775 /www/wwwroot/你的站点目录宝塔面板用户可以直接在【文件】里右键目录 →【权限】，把所有者设为 www、权限设为 755 并勾选”应用到子目录”。
方法二：手动创建 wp-config.php 完成安装
如果主机就是不允许自动写，最稳的办法是手动建。先复制根目录里的示例文件：
cp wp-config-sample.php wp-config.php然后用编辑器打开 wp-config.php，把数据库信息改成自己的：
// wp-config.php 手动填写区
define( 'DB_NAME', '你的数据库名' );
define( 'DB_USER', '你的数据库用户名' );
define( 'DB_PASSWORD', '你的数据库密码' );
define( 'DB_HOST', 'localhost' );
define( 'DB_CHARSET', 'utf8mb4' );
define( 'DB_COLLATE', '' );
// 安全密钥，去 https://api.wordpress.org/secret-key/1.1/salt/ 生成后整段替换
define( 'AUTH_KEY', 'put your unique phrase here' );
define( 'SECURE_AUTH_KEY', 'put your unique phrase here' );
define( 'LOGGED_IN_KEY', 'put your unique phrase here' );
define( 'NONCE_KEY', 'put your unique phrase here' );保存好后再访问域名，安装向导会跳过”写入配置文件”这一步，直接进入建站信息填写页面。
方法三：检查磁盘空间与目录属性
命令行查看空间和权限，确认不是被”空间满了”这类低级问题坑住：
df -h # 查看磁盘剩余空间
ls -l wp-config.php # 查看文件权限与所有者常见踩坑点
- 把整个网站目录都设成 777。 777 虽然能写，但等于把服务器大门敞开，极易被挂马。安装完一定要把其他文件降回 644、目录降回 755，只给必要文件写权限。
- 手动改 wp-config.php 时用记事本保存。 Windows 记事本可能写入 BOM 头，导致 PHP 输出空白或报错，建议用 VS Code、Notepad++ 并选 UTF-8 无 BOM。
- 密钥区没替换就上线。 示例里的 put your unique phrase here 必须换成真实密钥，否则站点安全性形同虚设。
- 权限加错了目录。 WordPress 装在子目录如
/blog，却只给根目录加了权限，安装依旧失败。 - 改完没重载。 部分环境修改所有者后需要重启 PHP-FPM 或等缓存刷新，刷新页面仍报错时先重试一次。
- 用主机控制面板改权限时没勾选应用到子目录。 只改了父目录而子目录权限不变，安装照样失败，改权限时务必勾选递归、把设置应用到所有子目录。
总结
“无法写入 wp-config.php”属于典型的权限问题，和数据库配置的对错无关，所以你完全不用怀疑自己填错了账号密码。处理的思路只有两条：一是给目录补上正确的所有者和写权限，让 WordPress 自动生成配置文件；二是彻底绕开自动写入，手动复制一份 wp-config.php 并把数据库信息和安全密钥填好。对国内虚拟主机用户来说，方法二往往更省心也更安全。等站点装好，记得把目录权限收紧回 755 与 644，既保留了可维护性，又不给攻击者留下可乘之机。另外，wp-config.php 里保存着数据库密码，最好只给这个文件必要的读写权限，不要让它对所有人开放，这样才算把这个安装拦路虎真正解决。
