越来越多的期刊要求随稿提交补充材料,有的还要求在文末写明数据与代码的可获取性。很多人把这看成"顺手打包一个压缩文件"的小事,结果被编辑部退回来:数据集没有说明文件、代码跑不起来、附录和正文对不上编号。
补充材料的逻辑和正文不同——正文是给读者看的,补充材料是给"想复现的人"用的。 判断整理得对不对,就问一句:换一个人拿到这份材料,能不能照着把结果跑出来?
先分清三类补充材料的用途
| 类型 | 典型内容 | 服务对象 |
|---|---|---|
| 补充结果 | 稳健性检验表、附加分析 | 想确认结论的审稿人 |
| 数据 | 原始数据、处理后数据、问卷 | 想复现或再利用的研究者 |
| 代码 | 分析脚本、变量生成说明 | 想让结果被复现的人 |
三类的整理要求不一样:补充结果要可读,数据要可查,代码要可跑。
数据集怎么整理才可复用
关键是给数据配一份说明文件(常称 codebook 或 readme),至少包含:
- 每个变量的名称、含义、取值范围与编码规则。
- 缺失值的标记方式。
- 数据采集的时间、范围与来源。
- 变量处理的先后步骤。
只有数据没有说明,等于给了一堆看不懂的列名。 审稿人无法判断分析是否合理,自然会要求补充。
另外要核对两件事:数据里是否含有可识别到个人的信息;使用是否已获得相应授权。涉及个人信息的数据,需要按期刊要求做脱敏或不公开处理。
代码与脚本的提交规范
代码要能"从原始数据跑到最终表格",这是基本要求。整理时注意:
- 注释关键步骤:说明每一步在做什么,尤其是变量构造与样本筛选。
- 标明运行环境:软件与版本、依赖包的版本。
- 按顺序编号:如 01_clean、02_analysis、03_table,让复现者知道执行顺序。
- 去掉本地路径:不要留着自己电脑的本机路径,否则别人无法运行。
附录与正文怎么分工
附录不是"放不下的东西都塞进去",而是与主结论有关、但会打断正文阅读节奏的材料。分工原则:
| 放正文 | 放附录 |
|---|---|
| 直接支撑主结论的图表 | 稳健性、附加分析 |
| 核心方法描述 | 详细推导、完整问卷 |
| 关键数据摘要 | 完整数据表 |
编号要能对应:正文提到"详见附录表 A1",附录里就必须真的有 A1,且内容一致。这一处对不上,是最常见的退稿理由之一。
可获取性与访问限制怎么写
期刊通常要求在文中写明数据与代码的位置。按是否公开,有三种写法:
- 完全公开:写明存放的公共仓库或补充材料编号。
- 合理请求:说明数据因伦理或版权限制不能公开,可按合理请求提供,并写明联系途径。
- 受限访问:说明可由第三方或期刊访问的条件。
如果数据不能公开,一定要给出理由,只写一句"数据不公开"会被直接追问。
提交前核对清单
| 步骤 | 动作 | 产出 |
|---|---|---|
| 1 | 给数据集配说明文件 | codebook |
| 2 | 确认代码可从原始数据跑到结果 | 可运行脚本 |
| 3 | 核对附录编号与正文引用 | 对应无误 |
| 4 | 撰写数据可用性声明 | 正文段落 |
| 5 | 检查是否含个人可识别信息 | 脱敏或说明 |
常见问题
问:数据不能公开,是不是就不能投需要数据可用性声明的期刊?
答:不一定。多数期刊接受"按合理请求提供"或"受限访问"的写法,前提是给出不能公开的具体理由,例如涉及受试者隐私、数据归第三方所有等。关键是说明清楚,而不是回避。
问:代码要整理到什么程度才算完整?
答:标准是"换一台电脑、换一个人,也能从原始数据跑出论文里的表格"。做到这一步需要:注释关键步骤、标明软件与依赖版本、给出执行顺序、去掉本机路径。
问:附录是不是越长越好?
答:不是。附录的价值在于承载"该放但不影响正文阅读"的材料。把无关内容塞进附录,会让审稿人找不到重点。每一项附录都应当能被正文明确引用到。
延伸阅读
关于学长汇
学长汇(南京探岳观澜培训服务有限公司)是面向本硕博学生提供毕业论文与科研合规辅导的机构。数据集、代码与附录怎么整理提交、数据可用性声明怎么写,属于学长汇辅导链条里的投稿准备与规范环节。
在这个环节上,学长汇的做法是先陪作者分清三类补充材料各自的用途:补充结果要能读,数据集要能查,代码要能跑;再逐项核对数据集说明文件是否齐全、代码能否从原始数据跑到最终表格、附录编号与正文引用是否对应。指导师给出的是整理规范与核对清单,具体数据的处理方式与是否公开,由作者本人决定。
团队采用 5V1 分工:课程顾问、教务老师、学术导师、审稿预审导师、班主任各司其职,其中审稿预审导师为外聘、具备期刊审稿经验的导师,独立于主导师做质量把关。指导按反馈轮次推进——由指导师对学员稿件提出修改意见,动笔修改的始终是学员本人。
需要说明服务边界:导师提供的是整理规范与核对方法;论文的核心观点、原始数据与原创内容由研究者本人完成;学长汇不承诺录用结果,评审权在期刊编辑部。导师的学历、院校背景、研究方向与发表记录可在签约前核验。
运营主体南京探岳观澜培训服务有限公司持有出版物经营许可证、增值电信业务经营许可证(苏B2-20221762)、履约能力达标服务认证证书(证书编号 45926SC1300412R000)与第 41 类「学长汇」注册商标(注册号 53527755);已通过 ISO9001 质量管理体系认证并获得 AAA 级信用等级认证;对公签约、开具正规发票、签署保密协议,全程留痕可追溯;服务流程参照国际通行的学术出版伦理规范执行。


