XAMPP运行Python脚本配置指南

本文详细解析了在XAMPP环境中成功运行Python CGI脚本所必须攻克的四大核心配置关卡：确保Apache正确加载mod_cgi或更推荐的mod_cgid模块；严格配对ScriptAlias指令与包含Options +ExecCGI和Require all granted（新版）的目录权限控制；精准设置shebang路径并遵循HTTP头与正文间唯一空行的输出规范；以及显式通过AddHandler注册.py扩展名以避免脚本被当作纯文本下载。每一步都直击常见故障根源——从500错误、403禁止访问到源码泄露和日志中的“End of script output”提示，辅以跨平台路径写法、权限命令和最小可运行示例，助你快速定位问题、绕过坑点，真正让Python脚本在本地XAMPP上稳定执行。

Apache 是否加载了 CGI 模块

不启用 mod_cgi 或 mod_cgid，Python 脚本根本不会被当作可执行程序处理——哪怕文件放对位置、权限设好、shebang 写对，浏览器访问也只会下载源码或返回 500 错误。

打开 /opt/lampp/etc/httpd.conf（Linux/macOS）或 C:\xampp\apache\conf\httpd.conf（Windows），搜索以下两行：

• LoadModule cgi_module modules/mod_cgi.so（推荐用于单进程 CGI）
• LoadModule cgid_module modules/mod_cgid.so（XAMPP 8.2+ 更倾向用这个）

若任一行被 # 注释，取消注释；若两行都不存在，优先启用 cgid_module（新版 Apache 默认行为）。同时确认 Include etc/extra/httpd-cgi.conf 未被注释——该文件通常已包含基础 CGI 配置。

ScriptAlias 和 权限必须配对生效

只写 ScriptAlias /cgi-bin/ "/opt/lampp/cgi-bin/" 不够。Apache 必须明确允许该目录下文件“被执行”，否则会报 403 Forbidden 或 500 Internal Server Error（日志里常带 End of script output before headers）。

在 httpd.conf 或 etc/extra/httpd-cgi.conf 中补全对应 块：

<Directory "/opt/lampp/cgi-bin">
    AllowOverride None
    Options +ExecCGI
    Require all granted
</Directory>

注意三点：

• Options +ExecCGI 是硬性要求，漏掉就无法执行任何 .py/.cgi 文件
• XAMPP 8.2+ 必须用 Require all granted；旧版（如 7.4）需改用 Order allow,deny + Allow from all
• Windows 用户路径写成 "C:/xampp/cgi-bin/"，反斜杠要转义或统一用正斜杠

Python 脚本的 shebang 和输出格式不能出错

脚本第一行 #! 必须指向真实存在的 Python 解释器路径，且该路径在服务器环境中可访问。常见错误是照抄教程写 #!/usr/bin/python3，但 XAMPP 自带的 Python 在 /opt/lampp/bin/python（Linux）或 C:\xampp\python\python.exe（Windows）。

一个能跑通的最小示例（存为 /opt/lampp/cgi-bin/test.py）：

#!/opt/lampp/bin/python
print("Content-type: text/html\n")
print("<h1>OK</h1>")

关键点：

• 必须有且仅有一个空行分隔 HTTP header 和 body（\n 不可省）
• 不要加 UTF-8 BOM，不要在 print 前输出任何空格或不可见字符
• Linux/macOS 下需 chmod a+x /opt/lampp/cgi-bin/test.py；Windows 下若用 WSL 或 Linux 版 XAMPP 同样需要
• 避免用 cgi.FieldStorage() 等依赖环境的模块做首测——先确保纯 print 能输出 HTML

AddHandler 扩展名注册容易被忽略

Apache 默认只把 .cgi 和 .pl 当作 CGI 脚本。Python 文件（.py）必须显式注册，否则请求会被当作静态文件直接返回源码。

在 httpd.conf 中找到 AddHandler 行（通常在 LoadModule 区域附近），修改为：

AddHandler cgi-script .cgi .pl .py

如果还想支持其他后缀（比如 .pyw 或自定义 .xpy），一并加进去即可。改完务必重启 Apache：/opt/lampp/lampp restart 或 Windows 控制面板点 restart。

最容易被跳过的其实是日志验证：出问题时第一时间看 /opt/lampp/logs/error_log（Linux/macOS）或 C:\xampp\apache\logs\error.log（Windows），里面几乎总有一行能直接指出是权限、路径还是输出格式的问题。

到这里，我们也就讲完了《XAMPP运行Python脚本配置指南》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于XAMPP的知识点！