#WorkBuddy# 自动化脚本半夜挂掉的 5 个真凶：路径、编码、时区、权限、超时（附零依赖体检脚本，macOS 实测）

# 环境：macOS，Python 3.9+，零第三方依赖
python3 env_probe.py                 # 跑全部 5 组（24 项）
python3 env_probe.py --section path  # 只跑路径组
python3 env_probe.py --json          # 输出 JSON，方便挂流水线
echo $?                              # 有 FAIL 返回 1，可直接做门禁

import subprocess, shlex, os
from pathlib import Path

# ① 波浪号只在 shell 里展开，argv 里就是字面量 "~"
subprocess.run(["python3", "job.py", "~/conf.json"])   # FileNotFoundError
Path(os.path.expanduser("~/conf.json"))                # ✅

# ② shell=True 时，空格和 & ( ) 会被 shell 当成语法
subprocess.run(f"cat {path}", shell=True)              # 路径含空格 → cat: xxx: No such file
subprocess.run(f"cat {shlex.quote(str(path))}", shell=True)  # ✅

# ③ 相对路径依赖 cwd，定时任务的 cwd 通常不是脚本目录
open("conf.json")                                      # 从 / 唤起 → FileNotFoundError
open(Path(__file__).with_name("conf.json"))            # ✅

[FAIL] P2 shell=True 时空格被当分隔符
        坑 : exit=1 cat: /var/folders/.../my: No such file or directory
        改 : exit=0 输出=hello
[FAIL] P5 路径含 & ( ) 直接拼进 shell 会变语法错误
        坑 : exit=2 /bin/sh: -c: line 0: syntax error near unexpected token `('
[FAIL] P3 相对路径在定时任务里几乎必挂（cwd 不一定是脚本目录）
        坑 : cwd=/ exit=1 ...FileNotFoundError
        改 : cwd=/ exit=0 输出={}

# ① 读别人给的 GBK 文件，默认 utf-8 直接炸
p.read_text()                     # UnicodeDecodeError: 0xd0 in position 0
p.read_text(encoding="gb18030")   # ✅ 兜底顺序 utf-8 → gb18030

# ② utf-8 BOM 会让第一个表头字段多一个 \ufeff
p.read_text(encoding="utf-8")      # 首列名='\ufeffname,qty' 长度=9
p.read_text(encoding="utf-8-sig")  # 首列名='name,qty' 长度=8

# ③ 反向坑：你写出去的 CSV，别人用 Excel 打开是乱码
p.write_text(txt, encoding="utf-8")      # 头三字节 b'\xe5\xa7\x93\xe5\x90\x8d'
p.write_text(txt, encoding="utf-8-sig")  # 头三字节 b'\xef\xbb\xbf' ✅

from datetime import datetime, timedelta, timezone

tz = timezone(timedelta(hours=8))
datetime.now() - datetime.now(timezone.utc)   # TypeError: can't subtract offset-naive...
datetime.fromisoformat("2026-10-27 09:00") < datetime.now(timezone.utc)  # 同样 TypeError
datetime.fromisoformat("2026-10-27T09:00+08:00")                        # ✅

os.chmod(parent_dir, 0o600)   # 父目录去掉 x 位
child.read_text()             # PermissionError —— 哪怕 child 是 0666

socket.getdefaulttimeout()    # None —— 意思是无限等
s.settimeout(1.0)             # ✅ 1.00 秒就抛 TimeoutError 收手

# subprocess 的 timeout 只杀直接子进程，孙进程会变孤儿
subprocess.run(["bash", "-c", "sleep 2731 & wait"], timeout=2)
# TimeoutExpired 抛出后：残留孤儿 1 个 -> 98840 sleep 2731

# ✅ 正确写法：独立进程组 + 整组 kill
p = subprocess.Popen(["bash", "-c", "sleep 2731 & wait"], start_new_session=True)
os.killpg(os.getpgid(p.pid), signal.SIGKILL)   # 残留 0 个

# 1. 体检：看自己环境有几处坑
python3 assets/env_probe.py                 # 24 项全跑
python3 assets/env_probe.py --section path  # 单组
python3 assets/env_probe.py --json > report.json

# 2. 对照：正确写法长什么样
python3 assets/env_fix_demo.py              # 期望输出 5/5，退出码 0

# 3. 挂进定时任务（每天开机后自检一次，失败才告警）
#    注意：定时任务里显式写死 TZ 与 PYTHONUTF8，别指望继承登录态环境
TZ=Asia/Shanghai PYTHONUTF8=1 PYTHONIOENCODING=utf-8 \
  /usr/bin/python3 /绝对路径/env_probe.py || echo "环境体检未通过"