从Spacemacs导出含西里尔字符的TaskJuggler文件失败

我之前处理西里尔文任务的时候也碰到过一模一样的编码问题，给你几个亲测有效的解决步骤：

1. 确保Org文件的编码是UTF-8 #

首先得保证你的Org文件本身用的是UTF-8编码：

• 在Org文件最开头添加属性声明：

  #+PROPERTY: encoding utf-8
  

• 或者在Spacemacs的配置文件（.spacemacs）里全局设置默认编码：

  (setq-default buffer-file-coding-system 'utf-8)
  (setq-default coding-system-for-read 'utf-8)
  (setq-default coding-system-for-write 'utf-8)
  

  别用ISO-8859-5这类西里尔专用编码，TaskJuggler默认只认UTF-8。

2. 给导出的TJP文件手动添加编码声明 #

有时候Org导出TaskJuggler文件时，不会自动加上编码配置，这会导致TJ3解析时出错。你需要在导出后的.tjp文件最顶部加上：

encoding "UTF-8";

如果想一劳永逸，可以修改Org到TaskJuggler的导出模板，让它自动插入这行。在Spacemacs里可以通过自定义org-taskjuggler-template变量来实现。

3. 验证导出过程的编码一致性 #

• 导出前用C-h v buffer-file-coding-system查看当前Org文件的编码，确认是utf-8-unix或者utf-8-dos（只要是UTF-8就行）。
• 导出后用文本编辑器打开.tjp文件，看看西里尔文本是否显示正常。如果显示乱码，说明Spacemacs导出时转码出错了，得检查你的Emacs编码相关配置。

4. 在HTML报告配置里指定UTF-8编码 #

生成HTML报告时，TaskJuggler需要明确输出编码。在你的.tjp文件的htmlreport区块里加上编码设置：

htmlreport project_report "项目报告" {
    encoding "UTF-8";
    outputdir "html-report";
    // 其他HTML配置...
}

这样生成的HTML文件会正确声明<meta charset="UTF-8">，浏览器就能正常解析西里尔文了。

5. 用最小化案例排查问题 #

如果以上方法都没用，建议建一个极简的Org文件测试：

#+TITLE: 测试西里尔任务
#+PROPERTY: encoding utf-8

* 任务 1 :taskjuggler:
:PROPERTIES:
:TaskJuggler_Priority: 1
:END:
完成西里尔文测试任务：Привет, мир!

导出成TJP再生成HTML，如果这个案例没问题，说明你原来的Org文件里可能有隐藏的非UTF-8字符（比如从Word或其他软件复制过来的特殊符号），需要逐个清理。

内容的提问来源于stack exchange，提问作者Bimawa