Apache必须加载mod_cgi或mod_cgid模块，否则Python脚本不会被当作可执行程序处理，即使位置、权限、shebang均正确，也会下载源码或返回500错误。
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）。
立即学习“Python免费学习笔记（深入）”；
在 httpd.conf 或 etc/extra/httpd-cgi.conf 中补全对应 <directory></directory> 块：
<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）。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
一个能跑通的最小示例（存为 /opt/lampp/cgi-bin/test.py）：
#!/opt/lampp/bin/python
print("Content-type: text/html\n")
print("<html><body><h1>OK</h1></body></html>")
关键点：
- 必须有且仅有一个空行分隔 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），里面几乎总有一行能直接指出是权限、路径还是输出格式的问题。
